Mengelola label lingkungan dan mengurai biaya lingkungan

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

  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 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:

  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 nilai label lingkungan Anda.

Langkah selanjutnya