All Products
Search
Document Center

Container Registry:Sinkronkan gambar menggunakan subscription artefak

Last Updated:Aug 21, 2026

Pengambilan container image dari registri eksternal seperti Docker Hub, Google Container Registry (GCR), dan Quay dapat gagal karena masalah jaringan. Fitur artifact subscription memungkinkan instans ACR Enterprise Anda menyinkronkan gambar langsung dari sumber eksternal atau kustom ke repository gambar Anda tanpa memerlukan konfigurasi jaringan tambahan.

Catatan penggunaan

Fitur ini hanya tersedia untuk edisi Basic dan Advanced dari instans ACR Enterprise. Kuota untuk aturan subscription bervariasi tergantung edisi instans. Untuk informasi selengkapnya, lihat artifact subscription.

Menyiapkan subscription otomatis

Setelah menyiapkan subscription otomatis, instans ACR Enterprise Anda akan secara otomatis menyinkronkan container image ke repository gambar tujuan sesuai aturan subscription.

  1. Masuk ke Konsol Container Registry.

  2. Pada bilah menu atas, pilih wilayah. Di panel navigasi sebelah kiri, klik Instances.

  3. Pada halaman Instances, klik instans ACR Enterprise yang dituju. Di panel navigasi sebelah kiri, pilih Repository > Artifact Subscription.

  4. Pada halaman Artifact Subscription, klik Create Subscription Rule. Pada kotak dialog, konfigurasikan parameter berikut, lalu klik Next.

    Parameter

    Deskripsi

    Artifact Source

    Pilih sumber eksternal tempat Anda berlangganan gambar. Jika Anda memilih Custom Source, repository sumber harus memenuhi semua persyaratan berikut:

    • Repository mematuhi protokol Docker Registry HTTP API V2.

    • Repository bersifat publik.

    • Repository dapat diakses melalui Internet menggunakan HTTPS.

    Source Repository Domain Name

    Opsi ini hanya muncul ketika Anda memilih Custom Source untuk Artifact Source, dan merupakan bidang wajib diisi.

    Nama domain sumber kustom. Contohnya, untuk gambar dari komunitas Anolis, masukkan anolis-registry.cn-zhangjiakou.cr.aliyuncs.com.

    Source Repository Location

    Jalur ke repository gambar sumber. Jalur harus dalam format <namespace>/<repository>. Contohnya, library/nginx.

    Subscription Policy

    Subscribe to the image tag in the source repository (Wajib): Ekspresi reguler yang menentukan versi gambar mana yang akan dilanggan. Nilai default .* cocok dengan semua versi gambar.

    Subscribe to the first N images in the source repository (Wajib): Jumlah versi gambar yang cocok untuk disinkronkan. Anda dapat menyinkronkan maksimal 5 versi dari Docker Hub dan maksimal 30 versi dari sumber lainnya.

    OS/Architecture

    Jika repository sumber berisi gambar multi-arsitektur, Anda dapat menentukan OS dan arsitektur agar hanya berlangganan gambar untuk platform tersebut.

  5. Pada halaman Repositories, konfigurasikan pengaturan berikut, lalu klik Create Subscription Rule.

    Parameter

    Deskripsi

    Repositories

    Repository gambar tujuan tempat gambar yang disinkronkan akan disimpan.

    Overwrite Image

    Menentukan apakah gambar yang sudah ada di repository tujuan akan ditimpa jika gambar yang disinkronkan memiliki nama yang sama.

    Acceleration Link

    Mengaktifkan penyinkronan gambar lebih cepat melalui kebijakan penjadwalan dan optimasi tautan jaringan.

    Update Period

    Menyinkronkan tag gambar dari repository sumber ke repository tujuan secara berkala.

  6. Setelah aturan dibuat, instans ACR Enterprise akan secara otomatis menyinkronkan gambar sesuai aturan tersebut. Jika Anda membutuhkan gambar sebelum sinkronisasi terjadwal berikutnya, Anda dapat menjalankan sinkronisasi segera.

Menjalankan sinkronisasi segera

Anda dapat secara manual memicu aturan subscription untuk menyinkronkan gambar kapan saja.

  1. Masuk ke Konsol Container Registry.

  2. Pada bilah menu atas, pilih wilayah. Di panel navigasi sebelah kiri, klik Instances.

  3. Pada halaman Instances, klik instans ACR Enterprise yang dituju. Di panel navigasi sebelah kiri, pilih Repository > Artifact Subscription.

  4. Pada halaman Artifact Subscription, temukan aturan subscription yang diinginkan dan klik Execute pada kolom Actions.

  5. Pada kotak dialog Tips, klik Confirm.

    Setelah tugas sinkronisasi selesai, Anda dapat melihat container image yang telah disinkronkan di repository gambar tujuan.