Memperbarui setelan repositori

Anda dapat memperbarui setelan repositori berikut:

  • Deskripsi repositori.

  • Detail autentikasi upstream repositori jarak jauh.

  • Tag image yang tidak dapat diubah untuk repositori Docker. Jika setelan ini diaktifkan, tag gambar akan selalu mengarah ke ringkasan gambar yang sama, termasuk tag latest default.

    Untuk mempelajari tag image, ringkasan image, dan tag image yang tidak dapat diubah lebih lanjut, lihat Versi image container.

  • Label repositori.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna memperbarui setelan repositori, minta administrator untuk memberi Anda peran IAM Artifact Registry Administrator (roles/artifactregistry.admin) di project Google Cloud. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Setelan pembaruan

Anda dapat memperbarui setelan menggunakan Konsol Google Cloud atau Google Cloud CLI.

Konsol

  1. Buka halaman Repositories di Konsol Google Cloud.

    Buka halaman Repositori

  2. Dalam daftar repositori, pilih repositori, lalu klik Edit Repository.

  3. Edit setelan yang ingin diubah:

    • Mengubah deskripsi repositori.
    • Perbarui detail autentikasi upstream repositori jarak jauh Anda.

    • Aktifkan atau nonaktifkan tag gambar yang tidak dapat diubah di bagian Tag gambar yang tidak dapat diubah. Jika Anda mengaktifkan setelan ini, tindakan berikut tidak akan diizinkan:

      • Hapus gambar yang diberi tag.
      • Menghapus tag dari gambar.
      • Kirim image dengan tag yang sudah digunakan oleh versi image lain dalam repositori.
      • Menambahkan, menghapus, atau memperbarui label.

  4. Klik Save.

gcloud

Untuk mengedit deskripsi repositori, jalankan perintah berikut:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --description="DESCRIPTION"

Untuk memperbarui detail autentikasi upstream repositori jarak jauh, jalankan perintah berikut:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT_ID/secrets/SECRET_ID/versions/SECRET_VERSION

Untuk mengedit mutabilitas tag gambar, jalankan salah satu perintah berikut:

Untuk menetapkan tag gambar ke tidak dapat diubah:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --immutable-tags

Untuk menetapkan tag gambar agar dapat diubah:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --no-immutable-tags

Untuk memperbarui label, jalankan perintah berikut:

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

Ganti nilai berikut:

  • REPOSITORY dengan nama repositori. Jika mengonfigurasi repositori default, Anda dapat menghilangkan flag ini untuk menggunakan default.
  • PROJECT-ID dengan ID project Google Cloud. Jika flag ini dihilangkan, project saat ini atau default akan digunakan.
  • LOCATION dengan lokasi regional atau multi-regional. Gunakan tanda ini untuk melihat repositori di lokasi tertentu. Jika mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan lokasi default.
  • DESCRIPTION dengan deskripsi untuk repositori.
  • USERNAME dengan nama pengguna repositori upstream Anda.
  • SECRET_ID dengan nama rahasia Anda.
  • SECRET_VERSION dengan versi rahasia yang ingin Anda gunakan.
  • TAG-SETTING menunjukkan cara tag dikaitkan dengan versi gambar.
  • --no-immutable-tags: versi image yang ditandai dapat berubah. Menghapus gambar, menghapus tag, dan mengubah versi gambar yang ditunjuk oleh tag diizinkan.
  • --immutable-tags: dalam repositori, tag selalu mengarah ke versi image yang sama. Tindakan berikut ini tidak diizinkan:
    • Hapus gambar yang diberi tag.
    • Menghapus tag dari gambar.
    • Kirim image dengan tag yang sudah digunakan oleh versi image lain dalam repositori.
  • KEY=VALUE,... dengan daftar label yang dipisahkan koma yang ditetapkan sebagai key-value pair. Contoh: team=team-1,product=example_product,stage=development. Untuk informasi selengkapnya tentang cara bekerja dengan label, lihat Repositori label.