Mengonfigurasi label untuk kumpulan pekerja

Label Cloud Run adalah pasangan nilai kunci yang diterapkan ke worker pool Cloud Run. Halaman ini menunjukkan cara menyetel, mengubah, dan menghapus label pada kumpulan pekerja Cloud Run Anda. Perhatikan bahwa saat Anda menetapkan label pada kumpulan pekerja Cloud Run, revisi baru dengan label ini akan dibuat untuk kumpulan pekerja ini; label tidak diterapkan ke revisi dengan versi lama.

Kemungkinan penggunaannya meliputi:

  • Alokasi biaya dan perincian penagihan.
  • Mengidentifikasi resource yang digunakan oleh tim individu atau pusat biaya.
  • Membedakan lingkungan deployment (prod, staging, qa, atau pengujian).
  • Mengidentifikasi pemilik dan label status.
  • Memfilter log di Logging.

Aturan penggunaan label

Aturan berikut berlaku untuk penggunaan label yang ditetapkan pada kumpulan worker Cloud Run:

Hanya label Google Cloud yang valid yang dapat digunakan di Cloud Run.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi dan men-deploy kumpulan pekerja Cloud Run, minta administrator Anda untuk memberi Anda peran IAM berikut:

Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika kumpulan pekerja Cloud Run Anda berinteraksi dengan Google Cloud API, seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.

Tetapkan atau ubah label

Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi selanjutnya juga akan otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan pembaruan eksplisit untuk mengubahnya.

Anda dapat menetapkan atau mengubah label menggunakan Google Cloud CLI saat membuat kumpulan pekerja baru atau men-deploy revisi baru:

gcloud

Anda dapat memperbarui label untuk kumpulan pekerja menggunakan perintah:

gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE

Untuk memperbarui lebih dari satu label, berikan daftar pasangan kunci dan nilai yang dipisahkan koma. Perhatikan bahwa perintah update-labels akan menetapkan nilai baru untuk kunci label jika label sudah ada. Jika tidak, label baru akan dibuat.

Ganti:

  • WORKER_POOL dengan nama kumpulan pekerja Cloud Run Anda
  • KEY dengan nama kunci label Anda
  • VALUE dengan nilai untuk kunci

Anda juga dapat menetapkan label selama deployment:

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE

Untuk membuat lebih dari satu label selama deployment, berikan daftar key-value pair yang dipisahkan koma.

Mencantumkan layanan berdasarkan label

Anda dapat menampilkan daftar layanan berdasarkan label menggunakan filter Google Cloud CLI:

  gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE

Replace:

  • LABEL dengan nama label
  • VALUE dengan nilai yang akan disertakan dalam daftar yang difilter

Menghapus label pada kumpulan pekerja

Anda dapat menggunakan Google Cloud CLI untuk menghapus label pada pool pekerja.

gcloud

Untuk menghapus semua label dari gabungan worker:

gcloud beta run worker-pools update WORKER_POOL --clear-labels

Untuk menghapus label tertentu dari kumpulan pekerja, berikan daftar kunci yang dipisahkan koma:

gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL

Ganti:

  • WORKER_POOL dengan nama kumpulan pekerja Cloud Run Anda
  • LABEL dengan nama label Anda