Menggunakan label

Pelajari cara membuat dan menggunakan label di layanan dan revisi penayangan 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 diterapkan ke revisi lama.

Label untuk penayangan Knative adalah label resource Kubernetes, dan tidak di-propagate ke Google Cloud. Untuk mempelajari lebih lanjut cara menggunakan label untuk menganalisis penggunaan resource cluster, lihat Memahami penggunaan resource cluster.

Aturan penggunaan label

Hanya label Kubernetes yang valid yang diizinkan untuk digunakan di 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 memperbarui layanan yang ada dan men-deploy revisi:

Konsol

1. Buka penayangan Knative di konsol Google Cloud:

Buka Inferensi 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 untuk layanan baru atau mengupdate layanan yang 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 pasangan nilai kunci, Anda dapat menentukan beberapa parameter untuk keterbacaan. 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 referensi 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 pasangan nilai kunci, Anda dapat menentukan beberapa parameter untuk keterbacaan. 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 dengan perintah gcloud run services describe menggunakan tanda --format=export. Kemudian, Anda dapat mengubah file YAML tersebut 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, 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 barunya menggunakan perintah berikut:

   gcloud run services replace service.yaml

Mencantumkan layanan berdasarkan label

Anda dapat mencantumkan 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 command line untuk menghapus label.

Konsol

1. Buka penayangan Knative di konsol Google Cloud:

Buka Inferensi 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