Label Cloud Run adalah pasangan nilai kunci yang diterapkan ke tugas Cloud Run. Halaman ini menunjukkan cara menyetel, mengubah, dan menghapus label pada tugas Cloud Run Anda.
Kemungkinan penggunaannya meliputi:
- Untuk mengalokasikan biaya dan merinci tagihan.
- Mengidentifikasi resource yang digunakan oleh tim individu atau pusat biaya.
- Membedakan lingkungan deployment (prod, staging, qa, atau pengujian).
- Mengidentifikasi pemilik, label status.
- Memfilter log di Logging.
Aturan penggunaan label
Aturan-aturan berikut berlaku untuk penggunaan label yang ditetapkan pada sebuah tugas Cloud Run:
Hanya label Google Cloud yang valid yang diizinkan untuk digunakan di Cloud Run.
Tetapkan atau ubah label
Anda dapat menggunakan Google Cloud CLI atau YAML untuk menetapkan label pada tugas Cloud Run.
Command line
Untuk menetapkan label pada pekerjaan baru:
gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE
Ganti
- JOB_NAME dengan nama tugas Anda.
- KEY dengan nama kunci label Anda
- VALUE dengan nilai untuk kunci label tersebut
- Ganti IMAGE_URL dengan sebuah referensi ke image container, sebagai
contoh,
us-docker.pkg.dev/cloudrun/container/job:latest
.
Untuk menetapkan label pada tugas yang telah ada:
gcloud run jobs update JOB_NAME --labels KEY=VALUE
Untuk membuat lebih dari satu label, tambahkan deretan pasangan nilai kunci yang dipisahkan dengan tanda koma.
gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2
YAML
Download dan lihat konfigurasi job yang ada menggunakan
perintah gcloud run jobs describe --format export
, yang akan
memberikan hasil yang dibersihkan dalam format YAML. Kemudian ubah kolom yang dijelaskan di bawah ini dan
upload YAML yang telah dimodifikasi menggunakan perintah gcloud run jobs replace
.
Pastikan Anda hanya mengubah kolom seperti yang didokumentasikan.
Untuk melihat dan mendownload konfigurasi:
gcloud run jobs describe JOB_NAME --format export > job.yaml
Update atribut
labels
di dua tempat:apiVersion: run.googleapis.com/v1 kind: Job metadata: labels: LABEL: VALUE spec: template: metadata: labels: LABEL: VALUE
Ganti
- LABEL dengan nama label
- VALUE dengan nilai yang diinginkan
Anda juga dapat menentukan konfigurasi lainnya, seperti variabel lingkungan atau batas memori.
Mengupdate konfigurasi tugas yang ada:
gcloud run jobs replace job.yaml
Urutkan tugas berdasarkan label
Anda dapat membuat daftar tugas berdasarkan label menggunakan filter Google Cloud CLI:
gcloud run jobs list --filter metadata.labels.LABEL=VALUE
Ganti:
- LABEL dengan nama label
- VALUE dengan nilai yang juga ingin diterapkan dalam penyaringan daftar
Hapus label pada tugas
Untuk menghapus semua label dari sebuah tugas:
gcloud run jobs update JOB --clear-labels
Untuk menghapus label-label tertentu dari sebuah layanan, tambahkan deretan nama kunci yang dipisahkan dengan tanda koma:
gcloud run jobs update JOB --remove-labels LABEL
Ganti
- JOB dengan nama tugas Cloud Run Anda
- LABEL dengan nama label Anda