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:
-
Cloud Run Developer (
roles/run.developer) di kumpulan pekerja Cloud Run -
Service Account User (
roles/iam.serviceAccountUser) pada identitas layanan
Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika kumpulan worker Cloud Run Anda berinteraksi dengan APIGoogle Cloud , 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 konsol, Google Cloud CLI, atau Terraform:
Konsol
Di konsol Google Cloud , buka Cloud Run:
Temukan kumpulan pekerja, lalu pilih kotak centang di sebelah kiri namanya.
Klik Label untuk menampilkan panel Label.
Untuk mengedit nilai kunci label yang ada, cari label dan ubah Nilai sesuai keinginan.
Untuk menetapkan label baru pada kumpulan pekerja, klik Tambahkan Label, lalu berikan kunci dan nilainya.
Klik Simpan
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 kode berikut:
- WORKER_POOL: nama kumpulan pekerja Cloud Run Anda
- KEY: nama kunci label Anda
- VALUE: 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.
Terraform
Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
launch_stage = "BETA"
template {
containers {
image = "IMAGE_URL"
}
}
labels = {
KEY : "VALUE"
}
}
Ganti kode berikut:
- WORKER_POOL: nama kumpulan pekerja
- REGION: region Google Cloud —misalnya,
europe-west1 - IMAGE_URL: referensi ke image container yang
berisi kumpulan pekerja, seperti
us-docker.pkg.dev/cloudrun/container/worker-pool:latest - KEY: nama kunci label Anda
- VALUE: nilai untuk kunci
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
Ganti kode berikut:
- LABEL: nama label
- VALUE: nilai yang akan disertakan dalam daftar yang difilter
Menghapus label pada kumpulan pekerja
Anda dapat menggunakan konsol Google Cloud atau Google Cloud CLI untuk menghapus label pada kumpulan pekerja.
Konsol
Di konsol Google Cloud , buka Cloud Run:
Temukan kumpulan pekerja, lalu pilih kotak centang di sebelah kiri namanya.
Klik Label untuk menampilkan panel Label.
Cari label yang ingin dihapus.
Di sebelah kanan kotak teks Nilai label, arahkan kursor untuk menampilkan ikon tempat sampah, lalu klik ikon tempat sampah.
Klik Simpan
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 kode berikut:
- WORKER_POOL: nama kumpulan pekerja Cloud Run Anda
- LABEL: nama label Anda