Mengelola label lingkungan dan memerinci biaya lingkungan

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Halaman ini menjelaskan cara menetapkan label ke lingkungan Cloud Composer dan mengelompokkan biaya penagihan berdasarkan label tersebut.

Tentang label lingkungan

Label lingkungan adalah pasangan nilai kunci yang dapat Anda tetapkan ke lingkungan fleksibel App Engine. Misalnya, jika owner:engineering-team adalah label khusus, 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 fleksibel App Engine.

Label lingkungan di laporan penagihan

Label lingkungan yang Anda tetapkan ke lingkungan dapat dilihat di penagihan sehingga Anda dapat mengelompokkan biaya berdasarkan kunci dan nilai dari label.

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

Menetapkan label ke lingkungan baru

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

Menetapkan label ke lingkungan yang ada

Konsol

  1. Buka halaman Environments di Google Cloud Console:

    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 Save.

  6. Tunggu hingga lingkungan diperbarui.

gcloud

Saat Anda memperbarui 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 tertentu yang tidak ada akan diabaikan.

Jika Anda menggunakan beberapa argumen ini, argumen tersebut akan diterapkan pada pesanan: --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, memperbarui, atau menghapusnya.
  • LABEL_VALUE dengan nilai label lingkungan.

Contoh

Contoh berikut memperbarui label owner dan membuat env baru label, 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 mengupdate lingkungan, di bagian Lingkungan menentukan label baru dari lingkungan Anda.

Mengganti semua label

Untuk mengganti semua label, sertakan labels dalam parameter kueri updateMask dan memberikan penggantinya di 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 tidak memberikan 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 pengganti 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 kueri updateMask dan tidak memberikan nilai pengganti.

Terraform

Untuk membuat lingkungan dengan parameter default adalah 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 memperbarui. 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 lingkungan Anda diterapkan ke laporan penagihan, Anda dapat mengelompokkan biaya penagihan berdasarkan label berikut:

  1. Melihat laporan Penagihan Cloud untuk Akun Penagihan Cloud Anda.

  2. Di halaman Laporan:

    1. Klik Show filters.
    2. Pada dialog Filter, luaskan bagian Label.
    3. Filter data yang ditampilkan berdasarkan kunci dan pada label lingkungan Anda.

Langkah selanjutnya