All Products
Search
Document Center

Container Registry:Buat repository dan image

Last Updated:Jun 22, 2026

Topik ini menjelaskan cara membuat repository image, mengonfigurasi aturan build, dan mem-build image menggunakan instans Edisi Personal.

Catatan penggunaan

Catatan

Timeout pembuatan image untuk instans Edisi Personal adalah 30 menit. Jika Anda memerlukan fitur lanjutan seperti konfigurasi build yang fleksibel, parameter build kustom, dan build multi-arsitektur, kami merekomendasikan menggunakan instans Edisi Perusahaan untuk mem-build image. Untuk informasi selengkapnya, lihat Build images by using an Enterprise Edition instance.

Sebelum mem-build image dengan instans Edisi Personal, pastikan image dasar dalam Dockerfile Anda memenuhi persyaratan berikut:

  • Anda dapat menggunakan gambar publik apa pun yang tidak memerlukan otorisasi.

  • Anda dapat menggunakan image privat dari akun yang sama dan di wilayah yang sama dengan instans Edisi Personal.

  • Anda tidak dapat menggunakan image privat dari wilayah yang berbeda.

  • Anda tidak dapat menggunakan image VPC dari wilayah mana pun.

  • Anda tidak dapat menggunakan image berlisensi pihak ketiga.

Sebagai contoh, image dasar dalam Dockerfile Anda dapat berupa gambar publik, tetapi tidak boleh berupa image berlisensi pihak ketiga.

Fitur

Catatan

Untuk menggunakan fitur build, Anda harus menghubungkan repository kode sumber ke instans Edisi Personal Anda. Anda dapat melakukannya setelah membuat instans tersebut.

  • Build otomatis saat terjadi perubahan kode

    Saat Anda mengaktifkan Automatically Build Images When Code Changes, Container Registry secara otomatis mem-build image setiap kali Anda melakukan commit kode. Hal ini menghilangkan kebutuhan untuk build manual.

    1. Login ke Container Registry console.

    2. Di bilah navigasi atas, pilih wilayah.

    3. Di panel navigasi sebelah kiri, klik Instances.

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

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

    6. Pada halaman Repositories, temukan repository target dan klik Manage di kolom Actions.

    7. Di panel navigasi sebelah kiri, klik Build, lalu aktifkan sakelar Automatically Build Images When Code Changes.

    Pengaturan build juga mencakup sakelar Overseas build dan Build without cache, yang keduanya dinonaktifkan secara default.

  • Overseas build

    Selama proses build, kode Anda mungkin bergantung pada sumber daya di luar Tiongkok daratan. Untuk skenario ini, Container Registry menyediakan fitur Build with Servers Deployed Outside Chinese Mainland. Setelah build selesai di mesin luar negeri, image akan didorong ke repository di wilayah yang Anda tentukan.

    Catatan

    Koneksi jaringan yang tidak stabil dari lokasi luar negeri ke Tiongkok daratan dapat menyebabkan timeout dan kegagalan saat mendorong image.

  • Build without cache

    Jika Anda mengaktifkan Build Without Cache, proses build akan menarik image dasar setiap kali, mengabaikan semua layer yang di-cache. Hal ini dapat memperpanjang waktu build, sehingga kami merekomendasikan agar opsi ini tetap dinonaktifkan.

  • Multi-stage build

    Container Registry juga mendukung multi-stage builds.

Langkah 1: Hubungkan sumber kode

Bagian ini menggunakan GitHub sebagai contoh untuk menunjukkan cara menghubungkan sumber kode. Untuk informasi tentang cara menghubungkan sumber kode lainnya, lihat Connect to a source code hosting platform.

Penting

Untuk mengakses instans GitLab privat di VPC, lihat Build container images with VPC secure build mode.

  1. Login ke Container Registry console.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sebelah kiri, klik Instances.

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

  5. Di panel navigasi sebelah kiri, pilih Repository > Code Source.

  6. Pada halaman Code Source, temukan GitHub dan klik Bind Account di kolom Actions.

  7. Pada kotak dialog GitHub, klik Go to the source code repository to bind account.

  8. Di halaman GitHub, masukkan username dan password Anda, lalu klik Sign in.

    Anda akan diarahkan kembali ke Container Registry console, dan muncul pesan You have successfully bound the GitHub account.

Langkah 2: Buat repository image

Sebelum membuat repository image, Anda harus memiliki namespace di wilayah yang diinginkan. Untuk informasi selengkapnya, lihat Manage namespaces.

  1. Login ke Container Registry console.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sebelah kiri, klik Instances.

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

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

  6. Pada halaman Repositories, klik Create Repository.

  7. Pada langkah Repository Info wizard, konfigurasikan Namespace, Repository Name, Summary, dan Repository Type. Pada contoh ini, pilih Private untuk tipe repository. Lalu, klik Next.

    Catatan

    Fitur pembuatan image tidak didukung untuk repository lokal.

  8. Pada langkah Code Source wizard, konfigurasikan Code Source, Build Settings, dan Build Rules, lalu klik Create Repository.

    Parameter

    Deskripsi

    Code Source

    Pilih sumber kode. Contoh ini menggunakan GitHub. Klik GitHub, lalu pilih namespace dan repository.

    Build Settings

    • Automatically build images upon code changes: Memicu aturan build saat Anda melakukan commit kode ke branch.

    • Overseas build: Mem-build image di pusat data luar negeri dan mendorongnya ke wilayah yang ditentukan. Jika tugas build Anda melibatkan sumber daya di Tiongkok daratan, seperti repository kode sumber dan repository image, kami merekomendasikan menonaktifkan Build with Servers Deployed Outside Chinese Mainland dan menggunakan server build di Tiongkok daratan.

    • Build without cache: Memaksa penarikan ulang image dependensi dasar untuk setiap build, yang dapat memperpanjang waktu build. Menonaktifkan opsi Build Without Cache mempercepat pembuatan image.

Langkah 3: Atur aturan build

Catatan

Jika Build tidak ditampilkan di halaman pengelolaan repository image Anda, sumber kode belum dihubungkan dengan benar. Lihat Langkah 1 untuk menghubungkannya kembali.

  1. Login ke Container Registry console.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sebelah kiri, klik Instances.

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

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

  6. Pada halaman Repositories, temukan repository target dan klik Manage di kolom Actions.

  7. Di panel navigasi sebelah kiri, klik Build. Di bagian Build Rules, klik Add Build Rule.

    Catatan

    Untuk mengubah aturan build, temukan aturan target dan klik Modify di kolom Actions.

  8. Pada kotak dialog Add Build Rule, atur parameter aturan build, lalu klik Confirm.

    Parameter

    Deskripsi

    Type

    Tipe sumber untuk dibuild. Nilai yang valid: Branch dan Tag.

    Branch/Tag

    Branch atau tag kode yang digunakan untuk build.

    Build Context Directory

    Jalur ke direktori yang berisi Dockerfile, relatif terhadap root dari branch atau tag yang ditentukan. Misalnya, jika Dockerfile Anda berada di direktori root branch master, atur parameter ini menjadi ./.

    Dockerfile Filename

    Nama file Dockerfile. Nilai default-nya adalah Dockerfile.

    Image Version

    Tag untuk image yang dibuild, seperti latest.

Langkah 4: Build image

  1. Login ke Container Registry console.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sebelah kiri, klik Instances.

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

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

  6. Pada halaman Repositories, temukan repository target dan klik Manage di kolom Actions.

  7. Di panel navigasi sebelah kiri, klik Build.

  8. Di bagian Build Rules, temukan aturan target dan klik Build di kolom Actions.

    Saat build selesai, catatan build baru akan dibuat.

    Catatan

    Untuk melihat log build, klik Log di kolom Actions catatan build tersebut.

  9. Setelah build selesai, klik Image Version di panel navigasi sebelah kiri untuk melihat image yang telah dibuild.

  10. Untuk melihat semua image, klik Build di panel navigasi sebelah kiri. Di Build Settings, aktifkan Build with Servers Deployed Outside Chinese Mainland dan Build Without Cache. Automatically Build Images When Code Changes diaktifkan secara default. Lalu klik Image Version di panel navigasi sebelah kiri untuk melihat semua tag image.

Langkah berikutnya