Mengelola label lingkungan dan mengelompokkan biaya lingkungan

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Halaman ini menjelaskan cara menetapkan label ke lingkungan Cloud Composer, lalu mengelompokkan biaya penagihan berdasarkan label ini.

Tentang label lingkungan

Label lingkungan adalah pasangan nilai kunci yang dapat Anda tetapkan ke lingkungan. Misalnya, jika owner:engineering-team adalah label kustom, maka owner adalah kunci, dan engineering-team adalah nilainya.

Setiap lingkungan dapat memiliki beberapa label, tetapi kunci label untuk satu lingkungan harus unik. Anda dapat menetapkan kunci dan nilai yang sama ke beberapa lingkungan.

Label lingkungan di laporan penagihan

Label lingkungan yang Anda tetapkan ke lingkungan akan terlihat dalam laporan penagihan, sehingga Anda dapat mengelompokkan biaya berdasarkan kunci dan nilai dari label.

Label tidak berlaku secara surut. Misalnya, jika Anda menetapkan label pada 15 Mei, biaya penagihan untuk 14 Mei tidak akan berisi label yang ditetapkan.

Menetapkan label ke lingkungan baru

Anda dapat menetapkan label saat membuat lingkungan. Untuk mengetahui informasi selengkapnya, lihat Membuat lingkungan.

Menetapkan label ke lingkungan yang ada

Konsol

  1. Buka halaman Environments di konsol Google Cloud:

    Buka Lingkungan

  2. Pilih lingkungan Anda.

  3. Buka tab Label.

  4. Klik Edit, lalu klik Tambahkan label.

  5. Tambahkan pasangan nilai kunci untuk label, lalu klik Simpan.

  6. Tunggu hingga lingkungan diperbarui.

gcloud

Saat Anda mengupdate lingkungan menggunakan perintah gcloud composer, argumen berikut menentukan label untuk lingkungan:

  • --clear-labels menghapus semua label.

  • --update-labels memperbarui label yang ditentukan; membuat label baru jika belum ada.

  • --remove-labels menghapus label yang ditentukan; label yang ditentukan yang tidak ada akan diabaikan.

Jika Anda menggunakan beberapa argumen ini, argumen tersebut akan diterapkan dalam urutan berikut: --clear-labels, --update-labels, --remove-labels.

Memperbarui atau membuat label

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --update-labels LABEL_KEY=LABEL_VALUE

Menghapus label yang ditentukan

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --remove-labels LABEL_KEY

Menghapus semua label

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --clear-labels

Ganti:

  • ENVIRONMENT_NAME dengan nama lingkungan.
  • LOCATION dengan region tempat lingkungan berada.
  • LABEL_KEY dengan kunci label lingkungan yang ingin Anda buat, perbarui, atau hapus.
  • LABEL_VALUE dengan nilai label lingkungan.

Contoh

Contoh berikut memperbarui label owner, membuat label env baru, dan menghapus label misc:

gcloud composer environments update example-environment \
    --location us-central1 \
    --update-labels owner=engineering-team,env=production \
    --remove-labels misc

API

Saat Anda memperbarui lingkungan, di resource Environment, tentukan label baru lingkungan Anda.

Mengganti semua label

Untuk mengganti semua label, sertakan labels dalam parameter kueri updateMask dan berikan penggantian dalam isi permintaan.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Ganti:

  • LABEL_KEY dengan kunci label lingkungan.
  • LABEL_VALUE dengan nilai baru untuk label lingkungan.

Contoh:

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Menghapus semua label

Untuk menghapus semua label, sertakan labels dalam parameter kueri updateMask dan jangan berikan nilai penggantian.

Memperbarui setiap label

Untuk memperbarui label atau menambahkan label baru ke label yang ada, sertakan labels.LABEL_KEY dalam parameter kueri updateMask dan berikan penggantian dalam isi permintaan.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Ganti:

  • LABEL_KEY dengan kunci label lingkungan.
  • LABEL_VALUE dengan nilai baru untuk label lingkungan.

Contoh:

// PATCH https://composer.googleapis.com/v1/
// ?name=projects/example-project/locations/
// us-central1/environments/example-environment
// &updateMask=labels.owner,labels.env

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Menghapus label satu per satu

Untuk menghapus label, sertakan labels.LABEL_KEY dalam parameter kueri updateMask dan jangan berikan nilai pengganti.

Terraform

Untuk membuat lingkungan dengan parameter default di lokasi yang ditentukan, edit blok labels di konfigurasi Terraform Anda dan jalankan terraform apply.

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

Ganti:

  • LABEL_KEY dengan kunci label lingkungan yang ingin Anda buat atau perbarui. Untuk menghapus label, hapus kolomnya.
  • LABEL_VALUE dengan nilai label lingkungan.

Contoh:

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    owner = "engineering-team"
    env = "production"
  }
}

Melihat label dalam laporan

Setelah label untuk lingkungan Anda diterapkan ke laporan penagihan, Anda dapat mengelompokkan biaya penagihan berdasarkan label ini:

  1. Lihat laporan Penagihan Cloud untuk akun Penagihan Cloud Anda.

  2. Di halaman Laporan:

    1. Klik Show filters.
    2. Di dialog Filters, luaskan bagian Labels.
    3. Filter data yang ditampilkan berdasarkan kunci dan nilai label lingkungan Anda.

Langkah selanjutnya