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
Masuk ke Konsol Container Registry.
Pada bilah navigasi atas, pilih wilayah.
Pada panel navigasi kiri, klik Instances.
Pada halaman Instances, klik instans Edisi Perusahaan yang ingin Anda kelola.
Pada panel navigasi kiri, pilih Repository > Repositories.
Pada halaman Repositories, temukan repositori yang ingin Anda konfigurasi, lalu klik Manage pada kolom Actions.
Pada halaman detail repositori, klik Edit pada bagian Details.
Pada kotak dialog Modify Settings, pilih Immutable, lalu klik Confirm.
CatatanUntuk menonaktifkan immutabilitas tag gambar, kosongkan centang pada Immutable.
Verifikasi immutabilitas tag gambar
Dorong gambar dengan tag selain
latestke repositori.docker push example-registry-vpc.cn-hangzhou.cr.aliyuncs.com/test/example:v1Push gambar lain dengan menggunakan tag yang sama.
Dorongan tersebut ditolak dengan error berikut:
The requested tag already exists and cannot be overwritten.Dorong gambar dengan tag
latest.docker push example-registry-vpc.cn-hangzhou.cr.aliyuncs.com/test/example:latestDorong gambar lain menggunakan tag
latest.Dorongan berhasil dan gambar
latestsebelumnya ditimpa. Hal ini mengonfirmasi bahwa taglatestdikecualikan dari immutabilitas.Kosongkan centang pada kotak Immutable untuk menonaktifkan immutabilitas tag gambar.
Dorong gambar lain menggunakan tag non-
latestyang 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.