Menggunakan label

Pelajari cara membuat dan menggunakan label di layanan penyaluran Knative dan beberapa revisi.

Label adalah key-value pair yang diterapkan ke layanan dan revisi. Kapan Anda menetapkan label pada layanan layanan Knative, sebuah revisi baru dengan label ini dibuat untuk layanan ini; label tidak diterapkan pada beberapa revisi.

Label untuk penyaluran Knative adalah Label resource Kubernetes, dan tidak disebarkan ke Google Cloud. Untuk mempelajari lebih lanjut tentang cara menggunakan label untuk menganalisis penggunaan resource cluster, lihat 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 Anda men-deploy service atau memperbarui layanan yang ada dan men-deploy revisi:

Konsol

  1. Buka penyaluran 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.

    Memberi 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 untuk memperbarui layanan yang ada:

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

    Contoh:

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

    Ganti:

    • SERVICE dengan nama layanan Anda.
    • KEY1=VALUE1,KEY2=VALUE2 dengan dipisahkan koma daftar pasangan nama dan nilai 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 agar mudah dibaca. Contoh: 
      [...]
--set-labels "KEY=VALUE1" \
--set-labels "KEY=VALUE2" \
--set-labels "KEY=VALUE3"

  • Untuk layanan baru, tetapkan label dengan menjalankan perintah gcloud run deploy dengan --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 dipisahkan koma daftar pasangan nama dan nilai 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 agar mudah dibaca. Contoh: 
      [...]
--set-labels "KEY=VALUE1" \
--set-labels "KEY=VALUE2" \
--set-labels "KEY=VALUE3"

YAML

Anda dapat mendownload konfigurasi layanan yang ada ke YAML dengan perintah gcloud run services describe menggunakan Tanda --format=export. Anda kemudian dapat memodifikasi file YAML itu 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 menjadi file bernama service.yaml pada ruang kerja lokal:

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

    Ganti SERVICE dengan nama Anda Layanan penyaluran Knative.

  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 barunya menggunakan perintah berikut:

    gcloud run services replace service.yaml

Mencantumkan layanan menurut label

Anda dapat menampilkan 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 penyaluran 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