Mengonfigurasi Label

Label Cloud Run adalah key-value pair yang diterapkan ke layanan dan revisi Cloud Run. Halaman ini menunjukkan cara menetapkan, mengubah, dan menghapus label pada layanan dan revisi Cloud Run Anda. Perhatikan bahwa saat Anda menetapkan label pada layanan Cloud Run, revisi layanan baru dengan label ini akan dibuat untuk layanan ini; label tidak diterapkan ke revisi dengan versi lama.

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 berikut berlaku untuk penggunaan label yang ditetapkan di layanan Cloud Run:

Hanya label Google Cloud yang valid yang diizinkan untuk digunakan di Cloud Run.

Menetapkan atau mengubah label

Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi berikutnya juga akan otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan pembaruan eksplisit untuk mengubahnya.

Anda dapat menetapkan atau mengubah label menggunakan Konsol Google Cloud, command line cgcloud, atau file YAML saat men-deploy revisi baru.

Konsol

  1. Di konsol Google Cloud, buka Cloud Run:

    Buka Cloud Run

  2. Centang kotak di sebelah kiri layanan tempat Anda menetapkan label.

  3. Pastikan Panel Info di ujung kanan diaktifkan (Tampilkan Panel Info).

  4. Klik Label untuk menampilkan panel label.

    Memberi label

  5. Untuk mengedit nilai kunci label yang ada, cari label dan ubah Nilai sesuai keinginan.

  6. Untuk menetapkan label baru pada layanan, klik Tambahkan Label, lalu berikan kunci dan nilainya.

  7. Klik Simpan

Command line

Anda dapat perbarui label untuk layanan menggunakan perintah:

gcloud run services update SERVICE --update-labels KEY=VALUE

Untuk memperbarui lebih dari satu label, berikan daftar key-value pair 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

  • SERVICE dengan nama layanan Cloud Run Anda
  • KEY dengan nama kunci label Anda
  • VALUE dengan nilai untuk kunci

Anda juga dapat menetapkan label selama deployment:

gcloud run deploy SERVICE --image IMAGE --labels KEY=VALUE

Untuk membuat lebih dari satu label selama deployment, berikan daftar key-value pair yang dipisahkan koma.

YAML

Anda dapat mendownload dan melihat konfigurasi layanan yang ada menggunakan perintah gcloud run services describe --format export, yang memberikan hasil yang telah diolah dalam format YAML. Kemudian, Anda dapat mengubah kolom yang dijelaskan di bawah ini dan mengunggah YAML yang telah dimodifikasi menggunakan perintah gcloud run services replace. Pastikan Anda hanya mengubah kolom seperti yang didokumentasikan.

  1. Untuk melihat dan mendownload konfigurasi:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Update atribut labels di dua tempat:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
      labels:
        LABEL: VALUE
    spec:
      template:
        metadata:
          labels:
            LABEL: VALUE
          name: REVISION

    Ganti

    • SERVICE dengan nama layanan Cloud Run Anda
    • LABEL dengan nama label
    • VALUE dengan nilai yang diinginkan
    • REVISION dengan nama revisi baru atau hapus (jika ada). Jika Anda memberikan nama revisi baru, nama tersebut harus memenuhi kriteria berikut:
      • Dimulai denganSERVICE-
      • Hanya berisi huruf kecil, angka, dan -
      • Tidak diakhiri dengan -
      • Tidak melebihi 63 karakter

    metadata.labels menetapkan label pada objek layanan, sedangkan spec.template.metadata.label menetapkan label pada revisi yang dibuat. Hanya label yang ditetapkan pada revisi yang akan diteruskan ke log dan penagihan.

  3. Ganti layanan dengan konfigurasi barunya menggunakan perintah berikut:

    gcloud run services replace service.yaml

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah Dasar Terraform.

Cuplikan berikut menambahkan dua label, foo (yang nilainya bar) dan baz (yang nilainya quux), ke instance Cloud Run Anda, menggunakan resource google_cloud_run_v2_service di konfigurasi Terraform Anda.

Menambahkan label di bagian template seperti yang ditunjukkan akan menetapkan label untuk revisi: hanya label yang ditetapkan untuk revisi yang akan diteruskan ke log dan penagihan. Jika Anda menambahkan label ke lokasi selain template, label akan ditetapkan untuk layanan, bukan revisi.

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-labels"
  location = "us-central1"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    # Labels
    labels = {
      foo : "bar"
      baz : "quux"
    }
  }
}

Ganti

  • Properti name dengan nama layanan Anda.
  • Properti location dengan lokasi yang digunakan untuk layanan Anda.
  • Properti image dengan image container Anda.
  • foo dan baz dengan nama label Anda sendiri.
  • bar dan quux dengan nilai label Anda sendiri.

Mencantumkan layanan berdasarkan label

Anda dapat menampilkan daftar layanan berdasarkan label menggunakan filter Google Cloud CLI:

  gcloud run services list --filter metadata.labels.LABEL=VALUE
  

Replace:

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

Menghapus label pada layanan

Anda dapat menggunakan konsol atau command line untuk menghapus label pada layanan.

Konsol

  1. Di konsol Google Cloud, buka Cloud Run:

    Buka Cloud Run

  2. Centang kotak di sebelah kiri layanan tempat Anda menghapus label.

  3. Pastikan Panel Info di ujung kanan diaktifkan (Tampilkan Panel Info).

  4. Klik Label untuk menampilkan panel label.

  5. Cari label yang ingin dihapus.

  6. Arahkan kursor ke sebelah kanan kotak teks Nilai untuk label guna menampilkan ikon tempat sampah, lalu klik ikon tempat sampah.

  7. Klik Simpan

Command line

Untuk menghapus semua label dari layanan:

gcloud run services update SERVICE --clear-labels

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

gcloud run services update SERVICE --remove-labels LABEL

Ganti

  • SERVICE dengan nama layanan Cloud Run Anda
  • LABEL dengan nama label Anda