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
Di konsol Google Cloud, buka Cloud Run:
Centang kotak di sebelah kiri layanan tempat Anda menetapkan label.
Pastikan Panel Info di ujung kanan diaktifkan (Tampilkan Panel Info).
Klik Label untuk menampilkan panel label.
Untuk mengedit nilai kunci label yang ada, cari label dan ubah Nilai sesuai keinginan.
Untuk menetapkan label baru pada layanan, klik Tambahkan Label, lalu berikan kunci dan nilainya.
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.
Untuk melihat dan mendownload konfigurasi:
gcloud run services describe SERVICE --format export > service.yaml
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 dengan
SERVICE-
- Hanya berisi huruf kecil, angka, dan
-
- Tidak diakhiri dengan
-
- Tidak melebihi 63 karakter
- Dimulai dengan
metadata.labels
menetapkan label pada objek layanan, sedangkanspec.template.metadata.label
menetapkan label pada revisi yang dibuat. Hanya label yang ditetapkan pada revisi yang akan diteruskan ke log dan penagihan.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.
Ganti
- Properti
name
dengan nama layanan Anda. - Properti
location
dengan lokasi yang digunakan untuk layanan Anda. - Properti
image
dengan image container Anda. foo
danbaz
dengan nama label Anda sendiri.bar
danquux
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
Di konsol Google Cloud, buka Cloud Run:
Centang kotak di sebelah kiri layanan tempat Anda menghapus label.
Pastikan Panel Info di ujung kanan diaktifkan (Tampilkan Panel Info).
Klik Label untuk menampilkan panel label.
Cari label yang ingin dihapus.
Arahkan kursor ke sebelah kanan kotak teks Nilai untuk label guna menampilkan ikon tempat sampah, lalu klik ikon tempat sampah.
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