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 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.
  • Setelan pemindaian kerentanan.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan 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 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 Repositori 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.
      • Mengirimkan 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 mutabilitas tag image, jalankan salah satu perintah berikut:

Untuk menetapkan tag gambar agar tidak dapat diubah:

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

Untuk menetapkan tag gambar ke 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 mengonfigurasi repositori default, Anda dapat menghapus tanda ini untuk menggunakan default.
  • PROJECT-ID adalah project ID Google Cloud . Jika flag ini dihilangkan, project saat ini atau default akan digunakan.
  • LOCATION adalah lokasi repositori regional atau multi-regional. Gunakan flag ini untuk melihat repositori di lokasi tertentu. Jika Anda 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 secret yang ingin Anda gunakan.
  • Dua flag setelan tag, --no-immutable-tags atau --immutable-tags, menunjukkan cara tag dikaitkan dengan versi gambar.
    • --no-immutable-tags: versi image yang ditunjuk tag dapat berubah. Menghapus gambar, menghapus tag, dan mengubah versi gambar yang ditunjuk 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.
      • Mengirimkan image dengan tag yang sudah digunakan oleh versi image lain di repositori.

  • KEY=VALUE... adalah daftar label yang dipisahkan koma yang ditentukan sebagai pasangan nilai kunci. Contoh: team=team-1,product=example_product,stage=development. Untuk mengetahui informasi selengkapnya tentang cara menggunakan label, lihat Repositori label.

Langkah selanjutnya