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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengonfigurasi tugas 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 tugas 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

Anda dapat menggunakan Google Cloud CLI atau YAML untuk menetapkan label pada tugas Cloud Run.

gcloud

  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

  1. Jika Anda membuat tugas baru, lewati langkah ini. Jika Anda mengupdate tugas yang ada, download konfigurasi YAML-nya:

    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