Container Registry:Buat gambar pada instans Container Registry Enterprise Edition

Langkah 1: Bind instans Anda ke platform hosting kode

Langkah 2: Buat namespace

Buat namespace untuk mengorganisasi repositori gambar Anda. Mengaktifkan pembuatan repositori otomatis memungkinkan Anda mengonfigurasi pengaturan default yang diterapkan ke semua repositori di bawah namespace ini.

1. Login ke Konsol Container Registry.

2. Di bilah navigasi atas, pilih Wilayah.

3. Di panel navigasi kiri, klik Instances.

4. Di halaman Instances, klik instans Enterprise Edition tempat Anda ingin membuat namespace.

5. Di panel navigasi kiri, pilih Repository > Namespace.

6. Di halaman Namespace, klik Create Namespace.

7. Di sidebar Create Namespace, konfigurasikan Namespace dan atur Automatically Create Repository ke On atau Off. Lalu klik Confirm.

   Jika Anda mengatur Automatically Create Repository ke On, konfigurasikan parameter berikut:

   Parameter	Deskripsi
   Repository Type	Pilih Public atau Private. Public: Secara default, gambar publik mengharuskan pengguna login ke instans sebelum dapat ditarik. Untuk mengizinkan penarikan anonim, aktifkan pengaturan penarikan anonim publik instans. Karena repositori publik dapat ditarik oleh pengguna tanpa otorisasi, atur repositori ke Private untuk melindungi data Anda. Private: Pengguna harus login ke instans dan memiliki otorisasi izin Pull sebelum dapat menarik gambar privat.
   Immutable Image Tags	Pilih Flexible atau Immutable. Saat diatur ke Immutable, semua tag gambar kecuali latest tidak dapat ditimpa.
   Accelerated Images	Saat diaktifkan, versi terakselerasi dari setiap gambar secara otomatis dihasilkan setelah gambar didorong. Gambar terakselerasi memiliki akhiran _accelerated yang ditambahkan ke tag-nya.

Langkah 3: Buat repositori gambar

Buat repositori gambar dan bind ke repositori kode sumber. Semua gambar yang dibuat dari repositori kode sumber tersebut akan didorong ke repositori gambar ini.

1. Login ke Konsol Container Registry.

2. Di bilah navigasi atas, pilih Wilayah.

3. Di panel navigasi kiri, klik Instances.

4. Di halaman Instances, klik instans Enterprise Edition yang ingin Anda kelola.

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

6. Di halaman Repositories, klik Create Repository.

7. Di langkah Repository Info, konfigurasikan Namespace, Repository Name, Repository Type, Tags, Accelerated Image, Summary, dan Description. Lalu klik Next.

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

9. Tabel berikut menjelaskan parameter Build Settings:

   Parameter	Deskripsi
   Automatically Build Images When Code Changes	Saat diaktifkan, aturan pembuatan secara otomatis dipicu ketika kode di-commit ke branch.
   Build With Servers Deployed Outside Chinese Mainland	Aktifkan opsi ini jika sumber kode Anda berada di GitHub atau Bitbucket, atau jika Dockerfile Anda mengunduh dependensi dari luar Tiongkok dan koneksi jaringan lintas batas tidak stabil. ACR menggunakan tautan terakselerasi untuk menarik sumber data eksternal selama pembuatan. Opsi ini hanya tersedia di wilayah tertentu. Jika opsi ini tidak muncul saat Anda membuat repositori gambar, wilayah saat ini tidak mendukung fitur ini.
   Build Without Cache	Saat diaktifkan, ACR menarik gambar dasar dari sumber setiap kali, mengabaikan layer cache. Hal ini dapat memperlambat pembuatan. Nonaktifkan opsi ini untuk menggunakan layer cache dan mempercepat pembuatan.

   Di halaman Repositories, klik repositori gambar yang telah dibuat. Jika Build ditampilkan di panel navigasi kiri halaman manajemen repositori, berarti repositori gambar telah di-bind ke repositori kode sumber.

Langkah 4: Buat gambar

Konfigurasikan aturan pembuatan untuk menentukan cara dan kapan ACR membuat gambar dari repositori Anda, lalu picu pembuatan dan verifikasi hasilnya.

1. Login ke Konsol Container Registry.

2. Di bilah navigasi atas, pilih Wilayah.

3. Di panel navigasi kiri, klik Instances.

4. Di halaman Instances, klik instans Enterprise Edition yang ingin Anda kelola.

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

6. Di halaman Repositories, temukan repositori gambar yang telah Anda buat dan klik Manage di kolom Actions.

7. Di panel navigasi kiri, klik Build. Di bagian Build Rules, klik Add Build Rule. Di langkah Build Information, konfigurasikan parameter berikut lalu klik Next.

   Parameter	Deskripsi
   Type	Jenis repositori kode sumber. Nilai yang valid: Branch dan Tag.
   Branch/Tag	Pilih atau masukkan branch atau tag. Ekspresi reguler didukung. Misalnya, jika Anda memasukkan release-(?<imageTag>\w*) , ACR secara otomatis membuat gambar ketika kode sumber di branch release-v1 diperbarui. Untuk informasi lebih lanjut tentang named capturing groups, lihat Gunakan ekspresi reguler dalam named capturing groups . Catatan Saat Anda menggunakan ekspresi reguler, hanya ACR yang dapat memicu pembuatan. Pembuatan manual tidak didukung.
   Build Context Directory	Direktori yang berisi Dockerfile, relatif terhadap root branch atau tag. Misalnya, jika branch adalah master dan Dockerfile berada di root branch, atur nilai ini menjadi /.
   Dockerfile Filename	Nama file Dockerfile. Nama default-nya adalah Dockerfile.

8. Di langkah Tag, konfigurasikan parameter berikut, klik Save, lalu klik Next.

   Catatan

   Klik Add Configuration untuk menambahkan tag gambar. Anda dapat menambahkan hingga tiga tag gambar.

   Parameter	Deskripsi
   Image Tag	Tag untuk gambar yang dibuat, misalnya latest. Named capturing groups didukung. Jika Anda telah menentukan named capturing group di Branch/Tag, referensikan nilai yang ditangkap di sini.
   Build Time	(Opsional) Waktu (UTC+8) saat kode sumber didorong. Format yang diterima: 20201015 atau 202010151613 . Catatan Jika Anda mengatur parameter ini, hanya ACR yang dapat memicu pembuatan. Pembuatan manual tidak didukung.
   Commit ID	(Opsional) Jumlah karakter yang digunakan dari ID commit kode yang paling baru didorong. Secara default, enam karakter pertama digunakan. Sesuaikan slider untuk mengubah jumlahnya. Catatan Jika Anda mengatur parameter ini, hanya ACR yang dapat memicu pembuatan. Pembuatan manual tidak didukung.

9. Di langkah Build Configurations, konfigurasikan parameter berikut lalu klik Next.

   Parameter	Deskripsi
   Build Architecture	Pilih satu atau beberapa arsitektur target. Jika Anda memilih beberapa arsitektur, ACR menghasilkan gambar terpisah untuk setiap arsitektur dengan tag yang sama.
   Build Parameters	Pasangan kunci-nilai yang diteruskan ke proses pembuatan. Nama parameter bersifat case-sensitive. Konfigurasikan hingga 20 parameter pembuatan dengan mengklik Add Configuration.

10. Picu build dengan salah satu metode berikut:

    • Di bagian Build Rules halaman Build, temukan aturan pembuatan dan klik Build di kolom Actions.

    • Dorong commit kode ke branch yang dikonfigurasi di repositori kode sumber untuk secara otomatis memicu aturan pembuatan.

11. Monitor pembuatan: Di bagian Build Log, temukan tugas pembuatan gambar dan klik Log di kolom Actions untuk melihat log pembuatan. Untuk menghentikan pembuatan yang sedang berjalan, klik Cancel di kolom Actions.

12. Verifikasi hasil: Di panel navigasi kiri, klik Image Tag. Jika gambar yang Anda buat tercantum, berarti pembuatan berhasil.

    Di panel navigasi kiri, klik Image Tag. Jika gambar yang Anda buat ditampilkan, berarti gambar telah berhasil dibuat.

Contoh

Dua contoh berikut mengilustrasikan konfigurasi aturan pembuatan umum. Contoh 1 adalah pengaturan sederhana yang mendukung pembuatan manual maupun otomatis. Contoh 2 menggunakan ekspresi reguler untuk membuat tag gambar versi dari nama branch rilis, dan hanya mendukung pembuatan otomatis.

Langkah berikutnya