全部产品
Search
文档中心

Container Registry:Buat repositori dan bangun images

更新时间:Jul 02, 2025

Topik ini menjelaskan cara menggunakan instance Container Registry Personal Edition untuk membuat repositori image, mengonfigurasi aturan pembuatan, dan membangun images.

Catatan Penggunaan

Catatan

Batas waktu untuk pembuatan image pada Personal Edition adalah 30 menit. Jika Anda memiliki kebutuhan lebih tinggi terkait pembuatan repositori dan image, seperti konfigurasi fleksibel, parameter kustom, atau pembuatan image multi-arsitektur, disarankan untuk menggunakan instance Container Registry Enterprise Edition. Untuk informasi lebih lanjut, lihat Gunakan Instance Container Registry Enterprise Edition untuk Membangun Image.

Sebelum menggunakan instance Container Registry Personal Edition untuk membangun images, pastikan bahwa image dasar dalam Dockerfile memenuhi persyaratan berikut:

  • Image dasar dapat berupa image Internet yang dapat diakses secara publik tanpa memerlukan otorisasi.

  • Image dasar dapat berupa image Internet pribadi yang dimiliki oleh akun dan wilayah yang sama dengan instance Container Registry Personal Edition.

  • Image dasar tidak boleh berasal dari wilayah berbeda dengan instance Container Registry Personal Edition.

  • Image dasar tidak boleh dioptimalkan untuk virtual private cloud (VPC), terlepas dari wilayahnya.

  • Image dasar tidak boleh disediakan oleh pihak ketiga.

Sebagai contoh, image dasar dalam Dockerfile dapat berupa image Internet yang dapat diakses secara publik dari instance Container Registry Personal Edition. Namun, image dasar tidak boleh berasal dari pihak ketiga.

Fitur

Catatan

Untuk membangun images, Anda harus mengaitkan repositori kode sumber ke instance Container Registry Personal Edition. Anda dapat melakukannya setelah membuat instance Personal Edition.

  • Membangun images secara otomatis saat kode berubah

    Setelah mengaktifkan Automatically Build Images When Code Changes, sebuah image akan dibangun secara otomatis setiap kali kode dikomit. Ini mengurangi beban kerja manual.

    1. Masuk ke Konsol Container Registry.

    2. Di bilah navigasi atas, pilih wilayah.

    3. Di panel navigasi sisi kiri, klik Instances.

    4. Di halaman Instances, klik instance Personal Edition yang ingin dikelola.

    5. Di panel navigasi sisi kiri halaman manajemen instance Personal Edition, pilih Repository > Repositories.

    6. Di halaman Repositories, temukan repositori yang ingin Anda kelola dan klik Manage di kolom Actions.

    7. Di panel navigasi sisi kiri, klik Build. Di halaman yang muncul, aktifkan Automatically Build Images When Code Changes.

    代码变更时自动构建镜像

  • Membangun images di server di luar Tiongkok Daratan

    Kode sumber yang digunakan untuk pembuatan image mungkin disimpan di repositori kode sumber di luar Tiongkok Daratan. Container Registry menyediakan fitur Build With Servers Deployed Outside Chinese Mainland untuk membantu Anda membangun images menggunakan server di luar Tiongkok Daratan. Setelah image dibangun di server tersebut, image akan didorong ke repositori di wilayah yang ditentukan.

    Catatan

    Pengiriman image mungkin mengalami timeout jika koneksi jaringan lintas batas tidak stabil.

    海外构建

  • Membangun images tanpa menggunakan cache

    Setelah mengaktifkan Build Without Cache, Container Registry menarik image dasar dari repositori image setiap kali Anda mencoba membangun image. Ini memperpanjang penarikan image. Kami sarankan Anda menonaktifkan Build Without Cache.

  • Pembuatan multi-tahap

    Container Registry mendukung pembuatan multi-tahap.

Langkah 1: Mengaitkan repositori kode sumber

Dalam contoh ini, GitHub digunakan untuk menjelaskan cara mengaitkan repositori kode sumber ke instance Container Registry Personal Edition. Untuk informasi tentang cara mengaitkan repositori kode sumber lainnya, lihat Mengaitkan Platform Hosting Kode Sumber.

Penting

Untuk informasi tentang cara mengaitkan repositori kode GitLab pribadi dalam VPC, lihat Bangun Image Kontainer dalam VPC.

  1. Masuk ke Konsol Container Registry.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sisi kiri, klik Instances.

  4. Di halaman Instances, klik instance Personal Edition yang ingin Anda kelola.

  5. Di panel navigasi sisi kiri halaman manajemen instance Container Registry Personal Edition, pilih Repository > Code Source.

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

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

  8. Di halaman log masuk GitHub, masukkan nama pengguna dan kata sandi Anda, lalu klik Sign in.

    Anda akan dialihkan ke Konsol Container Registry dan pesan berikut muncul: You have successfully bound the GitHub account.

Langkah 2: Membuat repositori image

Sebelum membuat repositori image, pastikan bahwa namespace telah dibuat di wilayah yang ditentukan. Untuk informasi lebih lanjut, lihat Kelola Namespaces.

  1. Masuk ke Konsol Container Registry.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sisi kiri, klik Instances.

  4. Di halaman Instances, klik instance Personal Edition yang ingin Anda kelola.

  5. Di panel navigasi sisi kiri halaman manajemen instance Personal Edition, pilih Repository > Repositories.

  6. Di halaman Repositories, klik Create Repository.

  7. Di langkah Repository Info, konfigurasikan Namespace, Repository Name, Repository Type, dan Summary. Dalam contoh ini, atur Repository Type menjadi Private. Lalu, klik Next.

    Catatan

    Anda tidak dapat membangun images berdasarkan repositori lokal.

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

    Parameter

    Deskripsi

    Code Source

    Pilih sumber kode. Dalam contoh ini, klik tab GitHub untuk memilih GitHub dan kemudian pilih namespace dan repositori.

    Build Settings

    • Membangun Images Secara Otomatis Saat Kode Berubah: Aturan pembuatan dipicu secara otomatis saat kode dikomit dari cabang.

    • Bangun Dengan Server yang Ditempatkan di Luar Tiongkok Daratan: Images dibangun di server di luar Tiongkok Daratan dan kemudian didorong ke repositori image di wilayah yang ditentukan. Jika sumber daya seperti repositori kode sumber dan repositori image kontainer yang Anda gunakan untuk membangun image ditempatkan di Tiongkok Daratan, kami sarankan Anda menonaktifkan fitur Build With Servers Deployed Outside Chinese Mainland untuk menggunakan server yang ditempatkan di Tiongkok Daratan.

    • Bangun Tanpa Cache: Sistem menarik image dasar dari repositori image setiap kali image dibangun. Ini mungkin memperpanjang periode pembuatan. Anda dapat menonaktifkan Build Without Cache untuk mempercepat pembuatan image.

Langkah 3: Konfigurasikan aturan pembuatan

Catatan

Jika Build tidak ditampilkan di panel navigasi sisi kiri halaman manajemen repositori image, sumber kode gagal dikaitkan ke instance Personal Edition. Anda dapat merujuk ke Langkah 1 untuk mengikat ulang sumber kode.

  1. Masuk ke Konsol Container Registry.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sisi kiri, klik Instances.

  4. Di halaman Instances, klik instance Personal Edition yang ingin Anda kelola.

  5. Di panel navigasi sisi kiri halaman manajemen instance Personal Edition, pilih Repository > Repositories.

  6. Di halaman Repositories, temukan repositori yang ingin Anda kelola dan klik Manage di kolom Actions.

  7. Di panel navigasi sisi kiri halaman manajemen repositori image, klik Build. Di bagian Build Rules, klik Add Build Rule.

    Catatan

    Jika Anda ingin memodifikasi aturan pembuatan, pilih aturan yang ingin Anda modifikasi dan klik Modify di kolom Actions.

  8. Di kotak dialog Add Build Rule, konfigurasikan aturan pembuatan dan klik Confirm.构建个人版

    Parameter

    Deskripsi

    Type

    Tipe repositori kode sumber. Nilai valid: Cabang dan Tag.

    Code Branch/Tag

    Cabang kode atau tag yang memicu aturan pembuatan.

    Build Context Directory

    Direktori Dockerfile. Ini adalah subdirektori dari direktori cabang atau tag. Sebagai contoh, jika direktori cabang adalah Master/ dan Dockerfile berada di direktori Master/, maka direktori Dockerfile adalah Master/Dockerfile.

    Dockerfile Filename

    Nama file Dockerfile. Nilai default adalah Dockerfile.

    Tags

    Tags dari image. Contoh: latest.

Langkah 4: Bangun image

  1. Masuk ke Konsol Container Registry.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sisi kiri, klik Instances.

  4. Di halaman Instances, klik instance Personal Edition yang ingin Anda kelola.

  5. Di panel navigasi sisi kiri halaman manajemen instance Personal Edition, pilih Repository > Repositories.

  6. Di halaman Repositories, temukan repositori yang ingin Anda kelola dan klik Manage di kolom Actions.

  7. Di panel navigasi sisi kiri halaman manajemen repositori, klik Build.

  8. Di bagian Build Rules, pilih aturan pembuatan yang ingin Anda gunakan dan klik Build di kolom Actions.

    Setelah pembuatan image selesai, catatan pembuatan akan dihasilkan.

    Catatan

    Pilih catatan pembuatan yang ingin Anda lihat dan klik Log di kolom Actions untuk melihat log pembuatan.

  9. Setelah pembuatan image selesai, klik Tags di panel navigasi sisi kiri untuk melihat images yang telah dibuat.

  10. Untuk melihat semua images, klik Build di panel navigasi sisi kiri. Di bagian Build Settings halaman yang muncul, aktifkan Build with Servers Deployed Outside Chinese Mainland dan Build Without Cache, serta biarkan status aktif default dari Automatically Build Images When Code Changes. Lalu, klik Tags di panel navigasi sisi kiri untuk melihat semua tag image.

Apa yang harus dilakukan selanjutnya