Menggunakan label untuk mengidentifikasi dan mengelompokkan repositori terkait. Anda dapat menentukan beberapa label untuk repositori.
Untuk mengelompokkan repositori dan resource lainnya di seluruh 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 repositori yang sama.
Apa itu 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 melampirkan label ke setiap resource, lalu memfilter resource berdasarkan labelnya. Informasi tentang label diteruskan ke sistem penagihan, sehingga Anda dapat mengelompokkan tagihan menurut 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 masing-masing 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
danteam:analytics
). Anda dapat menggunakan jenis label ini untuk penghitungan atau penganggaran biaya.Label komponen: Misalnya,
component:redis
,component:frontend
,component:ingest
, dancomponent:dashboard
.Label lingkungan atau tahap: Misalnya,
environment:production
danenvironment:test
.Label status: Misalnya,
state:active
,state:readytodelete
, danstate:archive
.Label kepemilikan: Digunakan untuk mengidentifikasi tim yang bertanggung jawab atas operasi, misalnya:
team:shopping-cart
.
Sebaiknya jangan membuat label unik dalam jumlah besar, seperti untuk stempel waktu atau nilai individual untuk 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 dan memperbarui label
Anda dapat menambahkan satu atau beberapa label ke repositori. Anda juga dapat mengedit nilai label yang ada.
Untuk memberi label repositori:
Konsol
Buka halaman Repositories di Konsol Google Cloud.
Pilih repositori.
Jika panel info di samping daftar repositori tidak terbuka, klik Show Info Panel.
Di panel info, klik tab Label.
Menambahkan atau mengedit label:
- Untuk menambahkan label, klik Tambahkan Label. Tentukan pasangan kunci dan nilai untuk label, lalu klik Save.
- Untuk mengedit label yang ada, ubah nilai label, lalu klik Save.
gcloud
Anda dapat menentukan satu atau beberapa label untuk ditambahkan atau diedit.
- Jika label ada, nilai yang sesuai akan diperbarui.
- Jika tidak ada, label akan dibuat.
- Jika perintah juga menyertakan flag
--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,..."
Dari mana
- REPOSITORY adalah nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan flag ini untuk menggunakan repositori default.
- PROJECT adalah project ID Google Cloud. Jika flag ini dihilangkan, project saat ini atau default akan digunakan.
- LOCATION adalah lokasi regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
KEY=VALUE,...
adalah daftar label yang dipisahkan koma yang ditetapkan sebagai key-value pair. Contoh:team=team-1,product=example_product,stage=development
.
Untuk mengetahui informasi selengkapnya tentang perintah ini, jalankan perintah berikut:
gcloud artifacts repositories update --help
Memfilter repositori menurut label
Anda dapat memfilter daftar repositori berdasarkan label di Google Cloud Console atau menggunakan Google Cloud CLI.
Konsol
Buka halaman Repositories di Konsol Google Cloud.
Di kolom Filter, pilih Labels sebagai kriteria filter, lalu masukkan pasangan kunci, nilai, atau nilai kunci.
Misalnya, untuk hanya menampilkan repositori dengan label
env:dev
, Anda dapat memasukkan salah satu opsi berikut:- Masukkan kunci:
env
- Masukkan nilai:
dev
- Masukkan pasangan nilai kunci:
env:dev
- Masukkan kunci:
gcloud
Untuk memfilter berdasarkan label, gunakan flag --filter
dengan perintah gcloud memadai repository 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 nilainya, 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
Buka halaman Repositories di Konsol Google Cloud.
Klik Select a repository.
Jika panel info di samping daftar repositori tidak terbuka, klik Show Info Panel.
Di panel info, klik tab Label.
Klik Hapus Item di samping label yang ingin dihapus.
gcloud
Anda dapat menghapus label tertentu atau 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
Dari mana
- REPOSITORY adalah nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan flag ini untuk menggunakan repositori default.
- PROJECT adalah project ID Google Cloud. Jika flag ini dihilangkan, project saat ini atau default akan digunakan.
- LOCATION adalah lokasi regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
LABEL,...
adalah daftar label yang dipisahkan koma, yaitu kunci dari setiap pasanganKEY=VALUE
. Contoh:team,product
.
Untuk mengetahui informasi selengkapnya tentang perintah ini, jalankan perintah berikut:
gcloud artifacts repositories update --help