Mengonfigurasi label untuk instance

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

Kemungkinan penggunaannya meliputi:

  • Alokasi biaya dan perincian tagihan.
  • 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 instance Cloud Run:

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

Label untuk data penagihan dan logging

Penagihan Cloud dan Cloud Logging hanya menerima label yang ditentukan dalam atribut spec.template.metadata.labels di YAML, atau di bagian template di Terraform. Jika Anda mengonfigurasi label menggunakan Google Cloud CLI, Cloud Run akan menambahkan label ke atribut metadata.labels dan spec.template.metadata.labels.

Peran yang diperlukan

Guna mendapatkan izin yang Anda perlukan untuk mengonfigurasi dan men-deploy instance 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 instance 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.

Menetapkan atau mengubah label

Anda dapat menetapkan atau mengubah label menggunakan Google Cloud CLI:

gcloud

Anda dapat memperbarui label untuk instance menggunakan perintah:

gcloud beta run instances update INSTANCE --update-labels KEY=VALUE

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

Ganti kode berikut:

  • INSTANCE: nama instance Cloud Run Anda.
  • KEY: nama kunci label Anda.
  • VALUE: nilai untuk kunci.

Anda juga dapat menetapkan label selama deployment:

gcloud beta run instances deploy INSTANCE --image IMAGE --labels KEY=VALUE

Untuk membuat lebih dari satu label selama deployment, berikan daftar pasangan kunci dan nilai yang dipisahkan koma.

YAML

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

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. Contoh berikut berisi konfigurasi YAML:

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    Ganti kode berikut:

    • INSTANCE: nama instance Cloud Run Anda.
    • KEY dan VALUE: pasangan kunci dan nilai untuk label.

    metadata.labels menetapkan label pada objek instance, sedangkan spec.template.metadata.labels menetapkan label pada revisi yang dibuat. Cloud Run hanya menyebarkan label yang ditetapkan pada revisi ke Penagihan Cloud dan Cloud Logging.

  3. Buat atau perbarui instance menggunakan perintah berikut:

    gcloud beta run instances replace instance.yaml

Mencantumkan instance berdasarkan label

Anda dapat mencantumkan instance berdasarkan label menggunakan filter Google Cloud CLI:

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

Ganti kode berikut:

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

Menghapus label pada instance

Anda dapat menggunakan Google Cloud CLI untuk menghapus label pada instance.

gcloud

Untuk menghapus semua label dari instance:

gcloud beta run instances update INSTANCE --clear-labels

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

gcloud beta run instances update INSTANCE --remove-labels LABEL

Ganti kode berikut:

  • INSTANCE: nama instance Cloud Run Anda.
  • LABEL: nama label Anda.