All Products
Search

This Product

    Container Registry:Push dan pull image

    Document Center

    Container Registry:Push dan pull image

    Last Updated:Sep 18, 2026

    Gunakan instans Container Registry Enterprise Edition untuk melakukan push, pull, menyimpan, dan mengelola container image di berbagai lingkungan.

    Prasyarat

    • Akun Alibaba Cloud telah dibuat. Daftar akun Alibaba Cloud.

    • Docker Engine telah diinstal. Instal dan gunakan Docker Engine dan Docker Compose.

    • OSS telah diaktifkan. Container Registry Enterprise Edition bergantung pada OSS. Aktifkan OSS.

    • Container Registry tidak mendukung pengunggahan image secara langsung di konsol. Anda harus melakukan push image melalui command line Docker: jalankan docker login untuk login ke instans, docker tag untuk memberi tag pada image, dan docker push untuk melakukan push image ke repository.

    Langkah 1: Buat instans Edisi Perusahaan

    1. Login ke Konsol Container Registry.

    2. Pada bilah navigasi atas, pilih wilayah.

    3. Di panel navigasi sebelah kiri, klik Instances.

    4. Pada halaman Instances, klik Create ACR EE.

    5. Pada halaman Create ACR EE, konfigurasi informasi dasar lalu klik Buy Now.

      Parameter

      Deskripsi

      Region

      Pilih wilayah penerapan instans.

      Specification

      Pilih tipe instans. Tipe yang tersedia dijelaskan dalam Apa itu Alibaba Cloud Container Registry (ACR)?.

      Name

      Masukkan nama instans.

      Instance Storage

      Nilai yang valid: Default dan Custom.

      • Default: Bucket OSS dibuat secara otomatis di akun Anda untuk menyimpan image.

      • Custom: Pilih bucket OSS yang sudah ada untuk menyimpan image.

      Select Bucket

      Pilih bucket OSS yang sudah ada untuk menyimpan image.

      Catatan

      Parameter ini hanya diperlukan jika Anda mengatur Instance Storage ke Custom.

      Security Scan

      Pilih mesin pemindaian:

      • Trivy Scan Engine: Mesin open source. Mendeteksi kerentanan sistem dan aplikasi. Tidak mendukung perbaikan satu-klik untuk kerentanan sistem.

      • Security Center Scan Engine: Mesin Alibaba Cloud. Mendeteksi kerentanan sistem, kerentanan aplikasi, risiko dasar, dan sampel berbahaya. Mendukung perbaikan satu-klik untuk kerentanan sistem.

      Repository quota

      Bawaan: 1.000 (Basic), 3.000 (Standard), 5.000 (Advanced). Anda dapat menambah kuota sesuai kebutuhan.

      Namespace quota

      Bawaan: 15 (Basic), 25 (Standard), 50 (Advanced). Anda dapat menambah kuota sesuai kebutuhan.

      VPC access control quota

      Beli kuota ini jika layanan Anda melakukan pull image melalui VPC. Penagihan.

      Subscription Duration

      Anda dapat memilih 1, 2, 3, atau 6 bulan, atau dari 1 hingga 5 tahun.

      Catatan

      Auto-renewal juga tersedia.

      Resource Groups

      Pilih Resource Group yang sudah ada. Anda juga dapat mengklik Create Resource Group dan, di kotak dialog yang muncul, masukkan Resource Group Identifier dan Resource Group Name, lalu klik Confirm.

    6. Pada halaman Confirm Order, verifikasi Parameters, tinjau Terms of Service and Service Level Agreement (SLA), lalu klik Payment.

    7. Pada halaman Pay, verifikasi total biaya dan selesaikan pembayaran.

      Pada halaman Instances, instans baru menampilkan status Starting. Setelah 2 hingga 3 menit, status berubah menjadi Running.

    Langkah 2: Dapatkan username repository

    • Jika Anda menggunakan akun Alibaba Cloud, nama akun adalah username Anda untuk repository image.

    • Jika Anda menggunakan Pengguna RAM, username Anda adalah bagian UPN sebelum .onaliyun.com. Misalnya, jika UPN Pengguna RAM Anda adalah 123@123456781011****.onaliyun.com, username Anda adalah 123@123456781011****.

    Langkah 3: Atur kata sandi repository

    Push dan pull image memerlukan kredensial tetap. Konfigurasikan kredensial akses.

    Langkah 4: Buat namespace

    1. Login ke Konsol Container Registry.

    2. Pada bilah navigasi atas, pilih wilayah.

    3. Di panel navigasi sebelah kiri, klik Instances.

    4. Pada halaman Instances, klik instans Edisi Perusahaan yang dituju.

    5. Di panel navigasi sebelah kiri halaman detail instans, pilih Repository > Namespace.

    6. Pada halaman Namespace, klik Create Namespace.

    7. Di sidebar Create Namespace, atur nama Namespace, pilih On atau Off untuk Automatically Create Repository, lalu klik Confirm.

      Jika Anda memilih On Automatically Create Repository, ikuti langkah-langkah berikut:

      Elemen UI

      Deskripsi

      Repository Type

      • Public: Secara default, pengguna harus login ke instans Edisi Perusahaan untuk melakukan pull gambar publik. Untuk mengizinkan pull anonim, Anda harus mengaktifkan akses anonim untuk instans tersebut.

        Kami menyarankan agar Anda mengatur tipe repository menjadi Private untuk memastikan keamanan data.

      • Private: Untuk melakukan pull gambar privat, pengguna harus login ke instans Edisi Perusahaan dan memiliki izin Pull yang diperlukan.

      Immutable Image Tags

      Flexible. Jika Anda memilih opsi ini, tag image di repository ini selain latest tidak dapat ditimpa, sehingga menjamin konsistensi tag container image.

      Accelerated Image

      Tentukan apakah fitur ini Off. Jika Anda memilih kotak centang ini, tag accelerated image dengan akhiran _accelerated akan dibuat secara otomatis di repository.

    Langkah 5: Buat repository image

    1. Login ke Konsol Container Registry.

    2. Pada bilah navigasi atas, pilih wilayah.

    3. Di panel navigasi sebelah kiri, klik Instances.

    4. Pada halaman Instances, klik instans Edisi Perusahaan yang dituju.

    5. Di panel navigasi sebelah kiri halaman detail instans, pilih Repository > Repositories.

    6. Pada halaman Repositories, klik Create Repository.

    7. Di wizard Repository Info, konfigurasi Namespace, Repository Name, Repository Type, Image Version, Accelerated Image, Summary, dan Description. Lalu, klik Next.

    8. Di wizard Code Source, konfigurasi Code Source, Build Settings, dan Build Rules. Lalu, klik Create Repository.

      Parameter

      Deskripsi

      Code Source

      Pilih sumber kode.

      Build Settings

      • Automatically Build Images When Code Changes: Memicu build pada setiap commit kode.

      • Build With Servers Deployed Outside Chinese mainland: Membangun image di luar daratan Tiongkok dan melakukan push ke wilayah yang Anda tentukan.

      • Build Without Cache: Selalu menarik base image terbaru. Dapat meningkatkan waktu build.

      Build Rules

      Setelah membuat repository, konfigurasikan aturan build di halaman build. Bangun repository dan image.

    Langkah 6: Konfigurasikan kontrol akses

    • Jika klien Docker Anda berada di VPC, konfigurasikan kontrol akses VPC agar dapat terhubung. Konfigurasikan daftar kontrol akses VPC.

    • Jika klien Docker Anda terhubung melalui internet, konfigurasikan kontrol akses internet untuk instans tersebut.

    1. Login ke Konsol Container Registry.

    2. Pada bilah navigasi atas, pilih wilayah.

    3. Di panel navigasi sebelah kiri, klik Instances.

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

    5. Di panel navigasi sebelah kiri halaman detail instans, pilih Repository > Access Control.

    6. Pada halaman Access Control, klik tab Internet, aktifkan sakelar Enable Access over Internet, lalu klik Add Internet Whitelist.

    7. Di kotak dialog Add Internet Whitelist, masukkan Blok CIDR host klien Docker Anda dan deskripsi, lalu klik Confirm.

      Klien Docker dari Blok CIDR yang ditentukan kemudian dapat mengakses instans tersebut.

      Penting

      Jika Anda ingin mengizinkan semua klien Docker di internet mengakses instans tersebut, Anda harus mengaktifkan akses internet dan menghapus semua entri dari daftar putih internet. Catatan: Mengekspos instans ke internet publik menimbulkan risiko keamanan. Lakukan dengan hati-hati.

    Langkah 7: Push dan pull image

    Jalankan perintah berikut dari klien Docker Anda.

    1. Login ke repository image:

      Catatan

      Jika Anda melakukan push ke atau pull dari repository image publik, Anda dapat mengaktifkan Pull from Anonymous Users di halaman Overview Konsol Container Registry. Ini memungkinkan Anda melakukan pull image secara anonim tanpa login.

      docker login --username=<username> <instance_name>-registry.<region>.cr.aliyuncs.com

      Contoh:

      docker login --username=123@1234567810111213 m**-registry.cn-hangzhou.cr.aliyuncs.com

      Saat diminta, masukkan kata sandi dari Langkah 3: Atur kata sandi repository. Pesan login succeeded menandakan keberhasilan.

    2. Push image.

      1. Beri tag pada image:

        docker tag <image_id> <instance_name>-registry.<region>.cr.aliyuncs.com/<namespace>/<repository_name>:<image_tag>

        Contoh:

        docker tag Digest m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest

      2. Push image:

        docker push <instance_name>-registry.<region>.cr.aliyuncs.com/<namespace>/<repository_name>:<image_tag>

        Contoh:

        docker push m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest

        Di halaman Repositories, klik nama repository yang dituju lalu pilih Image Version. Verifikasi bahwa image yang dipush muncul di halaman Image Version.

    3. Pull image:

      docker pull <instance_name>-registry.<region>.cr.aliyuncs.com/<namespace>/<repository_name>:<image_tag>

      Contoh:

      docker pull m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest

      Jalankan docker images untuk memverifikasi bahwa image muncul di output.