Menggunakan label

Pelajari cara membuat dan menggunakan label dalam layanan dan revisi Knative Anda.

Label adalah key-value pair yang diterapkan ke layanan dan revisi. Saat Anda menetapkan label pada layanan penayangan Knative, revisi baru dengan label ini akan dibuat untuk layanan ini; label tidak akan diterapkan ke revisi yang lebih lama.

Label untuk inferensi Knative adalah label resource Kubernetes, dan tidak diterapkan ke Google Cloud. Untuk mempelajari lebih lanjut penggunaan label untuk menganalisis penggunaan resource cluster, baca Memahami penggunaan resource cluster.

Aturan penggunaan label

Hanya label Kubernetes yang valid yang boleh digunakan pada penayangan Knative.

Menetapkan atau mengubah label

Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi selanjutnya 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, Google Cloud CLI, atau file YAML saat men-deploy layanan baru atau mengupdate layanan yang ada dan men-deploy revisi:

Konsol

1. Buka penayangan Knative di konsol Google Cloud:

Buka penayangan Knative

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

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

3. Klik Label untuk menampilkan panel label.

   

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

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

6. Klik Simpan

Command line

Anda dapat menggunakan Google Cloud CLI untuk menetapkan label pada layanan baru atau memperbarui layanan yang sudah ada:

• Untuk layanan yang ada, perbarui label dengan menjalankan perintah gcloud run services update dengan salah satu parameter berikut:

  • --set-labels
  • --update-labels
  • --remove-labels
  • --clear-labels

  Contoh:

  gcloud run services update SERVICE --update-labels KEY1=VALUE1,KEY2=VALUE2
  

  Ganti:

  • SERVICE dengan nama layanan Anda.
  • KEY1=VALUE1,KEY2=VALUE2 dengan daftar pasangan nama dan nilai yang dipisahkan koma untuk setiap label. Tentukan nama label untuk setiap KEY dan nilai untuk VALUE. Cara menentukan beberapa parameter.

  Opsi parameter perintah

  Untuk menentukan beberapa kumpulan key-value pair, Anda dapat menentukan beberapa parameter agar mudah dibaca. Contoh:

  [...]
  --set-labels "KEY=VALUE1" \
  --set-labels "KEY=VALUE2" \
  --set-labels "KEY=VALUE3"
  

  Oke

• Untuk layanan baru, tetapkan label dengan menjalankan perintah gcloud run deploy dengan parameter --set-labels:

  gcloud run deploy SERVICE --image=IMAGE_URL --set-labels KEY1=VALUE1,KEY2=VALUE2
  

  Ganti:

  • IMAGE_URL dengan mereferensikan ke image container, misalnya, gcr.io/cloudrun/hello.
  • SERVICE dengan nama layanan Anda.
  • KEY1=VALUE1,KEY2=VALUE2 dengan daftar pasangan nama dan nilai yang dipisahkan koma untuk setiap label. Tentukan nama label untuk setiap KEY dan nilai untuk VALUE. Cara menentukan beberapa parameter.

  Opsi parameter perintah

  Untuk menentukan beberapa kumpulan key-value pair, Anda dapat menentukan beberapa parameter agar mudah dibaca. Contoh:

  [...]
  --set-labels "KEY=VALUE1" \
  --set-labels "KEY=VALUE2" \
  --set-labels "KEY=VALUE3"
  

  Oke

YAML

Perhatian: Men-deploy perubahan konfigurasi menggunakan file YAML akan mengganti konfigurasi layanan yang ada. Karena file YAML sepenuhnya menimpa semua konfigurasi, Anda harus menghindari penggunaan beberapa metode untuk mengubah layanan. Misalnya, jangan gunakan file YAML bersama dengan konsol Google Cloud atau perintah gcloud.

Anda dapat mendownload konfigurasi layanan yang ada ke dalam file YAML menggunakan perintah gcloud run services describe menggunakan flag --format=export. Anda kemudian dapat memodifikasi file YAML dan men-deploy perubahan tersebut dengan perintah gcloud run services replace. Anda harus memastikan bahwa Anda hanya mengubah atribut yang ditentukan.

1. Download konfigurasi layanan Anda ke file bernama service.yaml di ruang kerja lokal:

   gcloud run services describe SERVICE --format export > service.yaml

   Ganti SERVICE dengan nama layanan penayangan Knative Anda.

2. Di file lokal Anda, perbarui atribut labels:

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

   Ganti

   • SERVICE dengan nama layanan penayangan Knative Anda
   • LABEL dengan nama label
   • VALUE dengan nilai yang diinginkan

3. Ganti layanan dengan konfigurasi baru menggunakan perintah berikut:

   gcloud run services replace service.yaml

Mencantumkan layanan menurut label

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

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

Ganti:

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

Menghapus label

Anda dapat menggunakan konsol atau label hapus pada command line.

Konsol

1. Buka penayangan Knative di konsol Google Cloud:

Buka penayangan Knative

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

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

3. Klik Label untuk menampilkan panel label.

4. Cari label yang ingin dihapus.

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

6. 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 penayangan Knative Anda
• LABEL dengan nama label Anda