Repositori label

Gunakan label untuk mengidentifikasi dan mengelompokkan repositori terkait. Anda dapat menentukan beberapa label untuk repositori.

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

Apa yang dimaksud dengan label?

Label adalah pasangan nilai kunci yang dapat Anda tetapkan ke repositori Google Cloud . Label membantu Anda mengatur resource ini dan mengelola biaya dalam skala besar, dengan perincian yang Anda butuhkan. Anda dapat menghubungkan label ke tiap resource, lalu memfilter resource menurut labelnya. Informasi tentang label akan 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: Tambahkan label berdasarkan tim atau pusat biaya untuk membedakan repositori yang dimiliki oleh tim yang berbeda (misalnya, team:research dan team:analytics). Anda dapat menggunakan jenis label ini untuk akuntansi 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 individu bagi tiap panggilan API. Masalah dari pendekatan ini adalah ketika nilai sering berubah atau dengan adanya kunci yang mengacaukan katalog, pemfilteran dan pelaporan resource secara efektif akan sulit dilakukan.

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 dan memperbarui label

Anda dapat menambahkan satu atau beberapa label ke repositori. Anda juga dapat mengedit nilai label yang ada.

Untuk memberi label pada repositori:

Konsol

  1. Buka halaman Repositori di Google Cloud konsol.

    Buka halaman Repositori

  2. Pilih repositori.

  3. Jika panel info di samping daftar repositori tidak terbuka, klik Tampilkan Panel Info.

  4. Di panel info, klik tab Label.

  5. Menambahkan atau mengedit label:

    1. Untuk menambahkan label, klik Tambahkan Label. Tentukan pasangan nilai kunci untuk label, lalu klik Simpan.
    2. Untuk mengedit label yang ada, ubah nilai label, lalu klik Simpan.

gcloud

Anda dapat menentukan satu atau beberapa label untuk ditambahkan atau diedit.

  • Jika label ada, nilai yang sesuai akan diperbarui.
  • Jika label tidak ada, label akan dibuat.
  • Jika perintah juga menyertakan tanda --clear-labels, semua label yang ada akan dihapus sebelum menambahkan label baru.

Jalankan perintah berikut:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --update-labels="KEY=VALUE,..."

Ganti kode berikut:

  • REPOSITORY adalah nama repositori. Jika Anda telah mengonfigurasi repositori default, Anda dapat menghapus flag ini untuk menggunakan default.
  • PROJECT adalah Google Cloud project ID. Jika flag ini tidak ada, project saat ini atau default akan digunakan.
  • LOCATION adalah lokasi repositori regional atau multi-regional. Anda dapat menghilangkan tanda `--location` untuk menggunakan default.
  • KEY=VALUE,... adalah daftar label yang dipisahkan koma dan ditentukan sebagai pasangan nilai kunci. Contoh: team=team-1,product=example_product,stage=development.

Untuk mengetahui informasi selengkapnya tentang perintah, jalankan perintah berikut:

gcloud artifacts repositories update --help

Memfilter repositori menurut label

Anda dapat memfilter daftar repositori menurut label di konsol Google Cloud atau menggunakan Google Cloud CLI.

Konsol

  1. Buka halaman Repositori di Google Cloud konsol.

    Buka halaman Repositori

  2. Di kolom Filter, pilih Label sebagai kriteria filter, lalu masukkan pasangan kunci-nilai, nilai, atau kunci Anda.

    Misalnya, agar hanya menampilkan repositori dengan label env:dev, Anda dapat memasukkan salah satu dari berikut ini:

    • Masukkan kunci: env
    • Masukkan nilai: dev
    • Masukkan pasangan nilai kunci: env:dev

gcloud

Untuk memfilter berdasarkan label, gunakan flag --filter dengan perintah gcloud artifacts repositories list.

Nilai flag --filter harus dalam format labels.KEY=VALUE. Misalnya, jika ingin memfilter repositori dalam project aktif pada label dengan env sebagai kunci dan dev sebagai nilai, Anda dapat menjalankan perintah ini:

gcloud artifacts repositories list --filter labels.env=dev

Untuk informasi selengkapnya tentang sintaksis filter di gcloud CLI, lihat dokumentasi gcloud topic filters.

Menghapus label

Untuk menghapus label:

Konsol

  1. Buka halaman Repositori di Google Cloud konsol.

    Buka halaman Repositori

  2. Klik Pilih repositori.

  3. Jika panel info di samping daftar repositori tidak terbuka, klik Tampilkan Panel Info.

  4. Di panel info, klik tab Label.

  5. Klik Hapus Item di samping label yang ingin Anda hapus.

gcloud

Anda dapat menghapus label tertentu atau menghapus semua label untuk repositori.

Untuk menghapus label tertentu, jalankan perintah berikut:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."

Untuk menghapus semua label, jalankan perintah berikut:

gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels

Ganti kode berikut:

  • REPOSITORY adalah nama repositori. Jika Anda telah mengonfigurasi repositori default, Anda dapat menghapus flag ini untuk menggunakan default.
  • PROJECT adalah Google Cloud project ID. Jika flag ini tidak ada, project saat ini atau default akan digunakan.
  • LOCATION adalah lokasi repositori regional atau multi-regional. Gunakan tanda ini untuk melihat repositori di lokasi tertentu. Jika Anda mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan default.
  • LABEL,... adalah daftar label yang dipisahkan koma, yaitu kunci dari setiap pasangan KEY=VALUE. Contoh: team,product.

Untuk mengetahui informasi selengkapnya tentang perintah, jalankan perintah berikut:

   gcloud artifacts repositories update --help