Cloud Composer 1 | Cloud Composer 2
Halaman ini menjelaskan cara menetapkan label ke lingkungan Cloud Composer, lalu memerinci biaya penagihan berdasarkan label tersebut.
Tentang label lingkungan
Label lingkungan adalah key-value pair yang dapat ditetapkan ke lingkungan Anda. Misalnya, jika owner:engineering-team
adalah label kustom, maka
owner
adalah kuncinya, 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 dalam laporan penagihan
Label lingkungan yang Anda tetapkan ke lingkungan akan terlihat dalam laporan penagihan, sehingga Anda dapat memerinci 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 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
Buka halaman Environments di Konsol Google Cloud:
Pilih lingkungan Anda.
Buka tab Label.
Klik Edit, lalu klik Tambahkan label.
Tambahkan pasangan nilai kunci untuk label, lalu klik Simpan.
Tunggu hingga lingkungan diperbarui.
gcloud
Saat Anda memperbarui lingkungan menggunakan
perintah gcloud composer
, argumen berikut
akan menentukan label untuk lingkungan tersebut:
--clear-labels
menghapus semua label.--update-labels
memperbarui label yang ditentukan; membuat label baru jika belum ada.--remove-labels
menghapus label yang ditentukan; label tertentu 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 tertentu
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 wilayah 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 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 pengganti 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 pengganti.
Memperbarui label satu per satu
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 adalah lokasi yang ditentukan, edit blok labels
dalam 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 di laporan
Setelah label untuk lingkungan diterapkan ke laporan penagihan, Anda dapat mengelompokkan biaya penagihan berdasarkan label berikut:
Melihat laporan Penagihan Cloud untuk akun Penagihan Cloud Anda.
Di halaman Laporan:
- Klik Show filters.
- Pada dialog Filter, luaskan bagian Label.
- Filter data yang ditampilkan berdasarkan kunci dan nilai label lingkungan Anda.