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 Anda mengaktifkan setelan ini, tag image akan selalu mengarah ke ringkasan image yang sama, termasuk tag latest default.

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

  • Label repositori.
  • Setelan pemindaian kerentanan.

Peran yang diperlukan

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

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. Di daftar repositori, pilih repositori, lalu klik Edit Repositori.

  3. Edit setelan yang ingin Anda ubah:

    • Ubah 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 diizinkan:
      • Menghapus gambar yang diberi tag.
      • Menghapus tag dari gambar.
      • Kirim image dengan tag yang sudah digunakan oleh versi image lain di repositori.
      • Menambahkan, menghapus, atau memperbarui label.
    • Aktifkan atau nonaktifkan pemindaian kerentanan.
  4. Klik Simpan.

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 kemampuan berubah tag image, jalankan salah satu perintah berikut:

Untuk menyetel tag gambar menjadi tidak dapat diubah:

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

Untuk menyetel tag gambar menjadi 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,..."

Untuk mengedit setelan pemindaian kerentanan, jalankan salah satu perintah berikut:

Untuk menonaktifkan pemindaian di repositori:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --disable-vulnerability-scanning

Untuk mengizinkan pemindaian di repositori:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --allow-vulnerability-scanning

Ganti nilai berikut:

  • REPOSITORY adalah nama repositori. Jika Anda mengonfigurasi repositori default, Anda dapat menghapus tanda ini untuk menggunakan default.
  • PROJECT-ID 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 mengonfigurasi lokasi default, Anda dapat menghilangkan tanda ini untuk menggunakan default.
  • DESCRIPTION adalah deskripsi untuk repositori.
  • USERNAME adalah nama pengguna repositori upstream Anda.
  • SECRET_ID adalah nama secret Anda.
  • SECRET_VERSION adalah versi rahasia yang ingin Anda gunakan.
  • Dua tanda setelan tag, --no-immutable-tags atau --immutable-tags, menunjukkan cara tag dikaitkan dengan versi gambar.
    • --no-immutable-tags: versi image yang ditunjuk oleh tag dapat berubah. Menghapus gambar, menghapus tag, dan mengubah versi gambar yang dituju oleh tag diizinkan.
    • --immutable-tags: di repositori, tag selalu mengarah ke versi image yang sama. Tindakan berikut tidak diizinkan:
      • Menghapus gambar yang diberi tag.
      • Menghapus tag dari gambar.
      • Kirim image dengan tag yang sudah digunakan oleh versi image lain di repositori.

  • 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 cara menggunakan label, lihat Memberi label pada repositori.

Langkah berikutnya