All Products
Search
Document Center

Container Registry:Aktifkan tag gambar kontainer yang tidak dapat diubah

Last Updated:Mar 26, 2026

Saat men-deploy gambar kontainer ke lingkungan produksi, Anda perlu memastikan bahwa gambar dengan tag tertentu tidak dapat diam-diam diganti oleh dorongan (push) berikutnya. Immutabilitas tag gambar mencegah penimpaan tag yang sudah ada: jika suatu dorongan menargetkan tag yang telah tersedia, ACR akan menolaknya dengan error The requested tag already exists and cannot be overwritten.

Immutabilitas tag gambar dikonfigurasi per repositori. Tag latest dikecualikan dan tetap dapat ditimpa meskipun immutabilitas diaktifkan.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

  • Instans ACR Edisi Perusahaan

  • Repositori dalam instans tersebut

Aktifkan immutabilitas tag gambar

  1. Masuk ke Konsol Container Registry.

  2. Pada bilah navigasi atas, pilih wilayah.

  3. Pada panel navigasi kiri, klik Instances.

  4. Pada halaman Instances, klik instans Edisi Perusahaan yang ingin Anda kelola.

  5. Pada panel navigasi kiri, pilih Repository > Repositories.

  6. Pada halaman Repositories, temukan repositori yang ingin Anda konfigurasi, lalu klik Manage pada kolom Actions.

  7. Pada halaman detail repositori, klik Edit pada bagian Details.

  8. Pada kotak dialog Modify Settings, pilih Immutable, lalu klik Confirm.

    Catatan

    Untuk menonaktifkan immutabilitas tag gambar, kosongkan centang pada Immutable.

Verifikasi immutabilitas tag gambar

  1. Dorong gambar dengan tag selain latest ke repositori.

    docker push example-registry-vpc.cn-hangzhou.cr.aliyuncs.com/test/example:v1
  2. Push gambar lain dengan menggunakan tag yang sama.

    Dorongan tersebut ditolak dengan error berikut:

    The requested tag already exists and cannot be overwritten.
  3. Dorong gambar dengan tag latest.

    docker push example-registry-vpc.cn-hangzhou.cr.aliyuncs.com/test/example:latest
  4. Dorong gambar lain menggunakan tag latest.

    Dorongan berhasil dan gambar latest sebelumnya ditimpa. Hal ini mengonfirmasi bahwa tag latest dikecualikan dari immutabilitas.

  5. Kosongkan centang pada kotak Immutable untuk menonaktifkan immutabilitas tag gambar.

  6. Dorong gambar lain menggunakan tag non-latest yang sama seperti pada langkah 1.

    Dorongan berhasil dan gambar tersebut menimpa gambar sebelumnya. Hal ini mengonfirmasi bahwa mengosongkan centang pada Immutable mengembalikan perilaku dorongan normal.