Container Registry:Buat repository dan build image

Sebelum memulai

Pastikan prasyarat berikut telah terpenuhi:

• Instans Container Registry Edisi Pribadi sudah ada di wilayah target Anda.

• Namespace telah dibuat dalam instans tersebut. Untuk petunjuknya, lihat Kelola namespace.

• Anda memiliki akun GitHub, Gitee, atau GitLab dengan repository yang berisi Dockerfile yang valid.

• Anda memiliki izin yang cukup untuk mengelola instans Container Registry Edisi Pribadi.

Langkah 1: Bind repository kode sumber

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 Pribadi yang ingin Anda kelola.

5. Pada panel navigasi kiri halaman pengelolaan instans, pilih Repository > Code Source.

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

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

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

   Anda akan diarahkan kembali ke Konsol Container Registry. Pesan konfirmasi akan muncul yang menunjukkan bahwa akun berhasil diikat.

Langkah 2: Konfigurasi informasi repository

Namespace harus sudah ada sebelum Anda membuat repository. Jika belum membuat namespace, lihat Kelola namespace.

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 Pribadi yang ingin Anda kelola.

5. Pada panel navigasi kiri halaman pengelolaan instans, pilih Repository > Repositories.

6. Pada halaman Repositories, klik Create Repository.

7. Pada langkah Repository Info, konfigurasikan bidang-bidang berikut:

   Field	Description
   Namespace	Pilih namespace tempat repository tersebut berada.
   Repository Name	Masukkan nama untuk repository. Gunakan huruf kecil, angka, tanda hubung (-), dan garis bawah (_).
   Repository Type	Pilih Private (hanya dapat diakses oleh pengguna yang berwenang) atau Public (dapat diakses siapa saja tanpa autentikasi).
   Summary	(Opsional) Masukkan deskripsi singkat tentang repository tersebut.

   Catatan

   Anda tidak dapat membangun image berdasarkan repository on-premises.

8. Klik Next.

Langkah 3: Konfigurasi sumber kode dan pengaturan build

1. Pada langkah Code Source, konfigurasikan bagian-bagian berikut: Code Source, Build Settings, dan Build Rules.

   Di bawah Code Source, pilih platform repository kode sumber (misalnya, GitHub), lalu pilih namespace dan repository yang berisi Dockerfile Anda.

   Di bawah Build Settings, konfigurasikan opsi-opsi berikut:

   Option	Description
   Automatically Build Images When Code Changes	Jika diaktifkan, aturan build akan dipicu secara otomatis saat kode di-commit dari suatu branch. Webhook menghubungkan repository kode sumber Anda ke ACR untuk mendeteksi event tersebut.
   Build With Servers Deployed Outside Chinese Mainland	Jika diaktifkan, image akan dibangun di server luar Tiongkok daratan lalu didorong ke repository di wilayah yang ditentukan. Aktifkan opsi ini jika kode sumber Anda di-host di luar Tiongkok daratan. Jika kode sumber dan repository gambar kontainer Anda berada di Tiongkok daratan, nonaktifkan Build With Servers Deployed Outside Chinese Mainland dan gunakan lingkungan build di Tiongkok daratan.
   Build Without Cache	Jika diaktifkan, setiap build dimulai dari awal dengan menarik kembali image dasar tanpa menggunakan layer cache. Hal ini dapat memperpanjang durasi build. Nonaktifkan Build without Cache untuk mempercepat proses build.

2. Klik Create Repository.

Langkah 4: Konfigurasi aturan build

Aturan build menentukan branch atau tag mana yang memicu build dan lokasi Dockerfile.

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 Pribadi yang ingin Anda kelola.

5. Pada panel navigasi kiri halaman pengelolaan instans, pilih Repository > Repositories.

6. Pada halaman Repositories, temukan repository yang ingin Anda kelola dan klik Manage pada kolom Actions.

7. Pada panel navigasi kiri halaman pengelolaan repository, klik Build.

8. Pada bagian Build Rules, klik Add Build Rule.

   Catatan

   Untuk mengubah aturan build yang sudah ada, temukan aturan tersebut dan klik Modify pada kolom Actions.

9. Pada kotak dialog Add Build Rule, konfigurasikan parameter-parameter berikut lalu klik Confirm.

   Parameter	Description
   Type	Jenis sumber pemicu. Pilih Branch untuk memicu build saat commit ke branch, atau Tag untuk memicu build saat tag yang sesuai didorong.
   Code Branch/Tag	Nama branch spesifik atau pola tag yang memicu aturan build.
   Build Context Directory	Subdirektori dalam branch atau tag yang menjadi konteks build. Misalnya, jika Dockerfile berada langsung di root branch, biarkan bidang ini kosong atau masukkan /. Jika Dockerfile berada di subdirektori bernama app, masukkan app/.
   Dockerfile Filename	Nama file Dockerfile. Nilai default-nya adalah Dockerfile. Ubah nilai ini hanya jika Dockerfile Anda menggunakan nama file non-standar.
   Tags	Tag image yang diterapkan pada image hasil build. Contoh: latest. Anda dapat menggunakan variabel seperti nama branch atau commit SHA untuk penandaan dinamis.

Langkah 5: Bangun image

Anda dapat memicu build secara manual kapan saja, terlepas dari apakah toggle Automatically Build Images When Code Changes diaktifkan atau tidak.

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 Pribadi yang ingin Anda kelola.

5. Pada panel navigasi kiri halaman pengelolaan instans, pilih Repository > Repositories.

6. Pada halaman Repositories, temukan repository yang ingin Anda kelola dan klik Manage pada kolom Actions.

7. Pada panel navigasi kiri halaman pengelolaan repository, klik Build.

8. Pada bagian Build Rules, temukan aturan build yang ingin Anda gunakan dan klik Build pada kolom Actions.

   Setelah build selesai, catatan build akan muncul dalam daftar.

   Catatan

   Untuk melihat log build, temukan catatan build tersebut dan klik Log pada kolom Actions. Jika build gagal, periksa log untuk mencari error seperti Dockerfile yang tidak ditemukan, image dasar yang tidak dapat diakses, atau timeout build (timeout Edisi Pribadi adalah 30 menit).

9. Setelah build selesai, klik Tags pada panel navigasi kiri untuk memverifikasi bahwa tag image berhasil dibuat.

Langkah selanjutnya

Setelah build berhasil, Anda dapat mengelola repository dan menggunakan image tersebut:

Tampilkan dan Gunakan Gambar

• View image tags: Klik Tags di panel navigasi kiri untuk melihat semua tag image yang telah dibangun beserta nilai digest-nya.

• Dorong dan tarik image: Dorong image ke dan tarik image dari repository image instans Container Registry Edisi Pribadi.

• Deploy ke kluster: Gunakan image yang telah dibangun untuk men-deploy aplikasi di Container Service for Kubernetes (ACK):

  • Buat Deployment

  • Buat StatefulSet

  • Buat Job

Kelola repository

• Lihat riwayat build: Di halaman pengelolaan repository, klik Build untuk melihat semua catatan build sebelumnya beserta statusnya.

• Lihat log build: Temukan catatan build dan klik Log pada kolom Actions untuk mendiagnosis masalah build.

• Ubah aturan build: Di bagian Build Rules, temukan aturan tersebut dan klik Modify pada kolom Actions untuk memperbarui kondisi pemicu atau pengaturan Dockerfile.

Tingkatkan untuk fitur lanjutan

• Tingkatkan ke Edisi Perusahaan: Untuk fitur lanjutan seperti konfigurasi build fleksibel, parameter kustom, build multi-arsitektur, dan kontrol keamanan yang ditingkatkan, lihat Gunakan instans Container Registry Edisi Perusahaan untuk membangun image.