Konfigurasikan label

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

  1. 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.
  2. Untuk menetapkan label pada tugas yang telah ada:

    gcloud run jobs update JOB_NAME --labels KEY=VALUE
  3. 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.

  1. Untuk melihat dan mendownload konfigurasi:

    gcloud run jobs describe JOB_NAME --format export > job.yaml
  2. 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.

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