Alur kerja label

Label adalah pasangan nilai kunci yang dapat Anda gunakan untuk mengidentifikasi dan mengelompokkan alur kerja terkait serta menyimpan metadata tentang alur kerja. Anda dapat menentukan beberapa label untuk alur kerja.

Halaman ini menjelaskan cara menggunakan label dengan alur kerja Anda. Panduan ini juga menjelaskan cara menambahkan, memperbarui, dan menghapus label untuk alur kerja.

Untuk mengelompokkan alur kerja dan resource lainnya di Google Cloud untuk pelaporan, audit, dan kontrol akses di organisasi Google Cloud Anda, gunakan tag. Tag dan label berfungsi secara independen satu sama lain, dan Anda dapat menerapkan keduanya ke alur kerja yang sama.

Apa yang dimaksud dengan label?

Label adalah pasangan nilai kunci yang dapat Anda tetapkan ke alur kerja Google Cloud . Label membantu Anda mengatur resource ini dan mengelola biaya dalam skala besar, dengan perincian yang Anda butuhkan. Anda dapat melampirkan label ke setiap resource, lalu memfilter resource berdasarkan labelnya. Informasi tentang label diteruskan ke sistem penagihan, sehingga Anda dapat mengelompokkan tagihan biaya berdasarkan label. Dengan laporan penagihan bawaan, Anda dapat memfilter dan mengelompokkan biaya berdasarkan label resource. Anda juga dapat menggunakan label untuk membuat kueri ekspor data penagihan.

Persyaratan untuk label

Label yang diterapkan ke resource harus memenuhi persyaratan berikut:

  • Setiap resource dapat memiliki maksimal 64 label.
  • Setiap label harus berupa pasangan nilai kunci.
  • Kunci memiliki panjang minimum 1 karakter dan panjang maksimum 63 karakter, serta tidak boleh kosong. Nilai boleh kosong dan memiliki panjang maksimum 63 karakter.
  • Kunci dan nilai hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda pisah. Semua karakter harus menggunakan encoding UTF-8, dan boleh menggunakan karakter internasional. Kunci harus diawali dengan huruf kecil atau karakter internasional.
  • Bagian kunci label harus unik dalam satu resource. Namun, Anda dapat menggunakan kunci yang sama dengan beberapa resource.

Batasan ini berlaku untuk kunci dan nilai untuk setiap label, serta untuk setiap resource Google Cloud yang memiliki label. Tidak ada batasan jumlah label yang dapat diterapkan di semua resource dalam satu project.

Penggunaan label secara umum

Berikut adalah beberapa kasus penggunaan umum untuk label:

  • Label tim atau pusat biaya: Menambahkan label berdasarkan tim atau pusat biaya untuk membedakan alur kerja yang dimiliki oleh tim yang berbeda (misalnya, team:research dan team:analytics). Anda dapat menggunakan jenis label ini untuk pencatatan atau penganggaran biaya.

  • Label komponen: Misalnya, component:redis, component:frontend, component:ingest, dan component:dashboard.

  • Label lingkungan atau tahap: Misalnya, environment:production dan environment:test.

  • Label status: Misalnya, state:active, state:readytodelete, dan state:archive.

  • Label kepemilikan: Digunakan untuk mengidentifikasi tim yang bertanggung jawab atas operasi, misalnya: team:shopping-cart.

Sebaiknya Anda tidak membuat label unik dalam jumlah besar, seperti untuk stempel waktu atau nilai individual bagi setiap panggilan API. Masalah dari pendekatan ini adalah ketika nilai sering berubah atau dengan kunci yang mengacaukan katalog, ini akan menyulitkan pemfilteran dan pelaporan resource secara efektif.

Label dan tag

Label dapat digunakan sebagai anotasi yang dapat dikueri untuk resource, tetapi tidak dapat digunakan untuk menetapkan kondisi pada kebijakan. Tag menyediakan cara untuk mengizinkan atau menolak kebijakan secara bersyarat berdasarkan apakah resource memiliki tag tertentu, dengan memberikan kontrol terperinci atas kebijakan. Untuk informasi selengkapnya, lihat Ringkasan tag.

Menambahkan atau memperbarui label

Anda dapat menambahkan satu atau beberapa label ke alur kerja saat membuat alur kerja. Anda juga dapat menambahkan atau mengedit label saat memperbarui alur kerja.

Jika Anda memperbarui label yang ada, atau menambahkan label baru, perlu waktu hingga 10 menit agar label baru dapat diterapkan.

Memfilter alur kerja menurut label

Anda dapat menelusuri dan mencantumkan alur kerja tertentu dengan memfilternya menurut label.

Konsol

  1. Di konsol Google Cloud, buka halaman Workflows:

    Buka Workflows

  2. Di kolom Filter, pilih Labels sebagai kriteria filter dan, dalam daftar Values, pilih pasangan nilai kunci.

gcloud

Gunakan flag --filter dengan perintah gcloud workflows list:

gcloud workflows list \
    --filter labels.KEY=VALUE

Ganti KEY dan VALUE dengan pasangan nilai kunci label.

Untuk mengetahui informasi selengkapnya tentang sintaksis filter di Google Cloud CLI, lihat gcloud topic filters.

Label alur kerja diwariskan oleh eksekusi alur kerja. Untuk melihat label eksekusi, gunakan metode workflows.executions.list untuk mencantumkan dan memfilter eksekusi alur kerja.

Hapus label

Anda dapat menghapus label tertentu menggunakan konsol Google Cloud, atau menggunakan gcloud CLI untuk menghapus semua label dari alur kerja.

Konsol

  1. Di konsol Google Cloud, buka halaman Workflows:

    Buka Workflows

  2. Klik nama alur kerja yang ingin Anda perbarui.

    Halaman Detail alur kerja akan muncul.

  3. Klik Edit.

    Halaman Edit alur kerja akan muncul.

  4. Di samping label yang ingin Anda hapus, klik Hapus item.

  5. Klik Berikutnya.

  6. Untuk men-deploy ulang alur kerja, klik Deploy.

gcloud

Gunakan flag --labels dengan nilai kosong dan perintah gcloud workflows deploy:

gcloud workflows deploy WORKFLOW_NAME \
    --labels="" \
    --source=YAML_OR_JSON_SOURCE_FILE

Ganti kode berikut:

  • WORKFLOW_NAME: nama alur kerja Anda.

  • YAML_OR_JSON_SOURCE_FILE: file sumber untuk alur kerja dalam format YAML atau JSON. Contoh: myFirstWorkflow.yaml.