Gunakan replikasi remote Harbor untuk mereplikasi gambar secara satu arah dari registri Harbor yang dikelola sendiri ke instans Container Registry (ACR) Enterprise Edition. Tambahkan nama domain kustom untuk mendukung pemulihan bencana geo pada registri gambar kontainer.
Jika Anda lebih memilih tidak menggunakan fitur replikasi remote Harbor atau jika kecepatan replikasi sangat penting, lihat Migrasi Harbor yang dikelola sendiri ke ACR Enterprise Edition.
Prasyarat
Instans ACR Enterprise Edition telah dibuat. Untuk informasi selengkapnya, lihat Buat instans Enterprise Edition.
Prosedur
Replikasi gambar Harbor ke instans Enterprise Edition
Jika registri Harbor dideploy di pusat data on-premises, Anda harus terlebih dahulu menghubungkan pusat data tersebut ke VPC Anda di Alibaba Cloud. Untuk informasi selengkapnya, lihat Akses instans Enterprise Edition lintas wilayah atau dari pusat data.
Langkah 1: Buat namespace
Masuk ke Konsol Container Registry.
Di bilah navigasi atas, pilih wilayah.
Di panel navigasi kiri, klik Instances.
Pada halaman Instances, klik instans Enterprise Edition tujuan.
Di halaman manajemen instans Enterprise Edition, pilih .
Di halaman Namespace, klik Create Namespace.
Di sidebar Create Namespace, tentukan nama Namespace dan pilih On atau Off untuk Automatically Create Repository. Lalu, klik Confirm.
Parameter
Deskripsi
Namespace
Masukkan nama proyek Harbor yang ingin direplikasi, misalnya test-project.
Automatically Create Repository
Pilih On.
CatatanJika Anda memilih Off, Anda harus membuat repository yang sesuai di dalam namespace sebelum mereplikasi gambar.
Langkah 2: Konfigurasikan repository tujuan di Harbor
Masuk ke Harbor.
Di panel navigasi kiri, pilih .
Di halaman Registries, klik NEW ENDPOINT.
Di kotak dialog New Registry Endpoint, konfigurasikan parameter yang dijelaskan dalam tabel berikut:
Parameter
Deskripsi
Provider
Pilih Docker Registry.
Name
Masukkan nama untuk endpoint baru.
Description
Masukkan deskripsi untuk endpoint baru.
Endpoint URL
Masukkan titik akhir repository tujuan pada instans Enterprise Edition, dan pastikan kontrol akses diaktifkan. Untuk informasi selengkapnya, lihat Konfigurasikan kontrol akses VPC dan Konfigurasikan akses Internet.
VPC:
Contoh:
https://<Nama instans Enterprise Edition>-registry-vpc.cn-qingdao.cr.aliyuncs.com.Internet:
Contoh:
https://<Nama instans Enterprise Edition>-registry.cn-qingdao.cr.aliyuncs.com.
Access ID
Masukkan nama logon repository tujuan, yaitu nama Akun Alibaba Cloud Anda.
Access Secret
Masukkan password yang digunakan untuk mengakses repository tujuan. Untuk informasi selengkapnya, lihat Gunakan password permanen.
Pilih kotak centang Verify Remote Cert dan klik TEST CONNECTION. Jika muncul pesan Connection tested successfully, parameter yang Anda masukkan valid. Klik OK.
Langkah 3: Konfigurasikan aturan replikasi
Masuk ke Harbor.
Di panel navigasi kiri, pilih Administration > Replications.
Di halaman Replications, klik NEW REPLICATION RULE.
Di kotak dialog New Replication Rule , konfigurasikan parameter yang dijelaskan dalam tabel berikut. Lalu, klik Save.
Parameter
Deskripsi
Name
Masukkan nama untuk aturan replikasi.
Description
Masukkan deskripsi untuk aturan replikasi.
Replication mode
Pilih Push-based.
Source resource filter
Filter resource yang ingin direplikasi sesuai petunjuk di UI Harbor. Secara default, semua resource direplikasi.
Destination registry
Pilih endpoint yang telah Anda buat di Langkah 2.
Destination
Di bidang Namespace, masukkan namespace yang telah Anda buat di Langkah 1 pada instans Enterprise Edition. Flattening mengurangi hierarki repository selama replikasi. Pilih Flatten 1 Level. Contoh:
harbor-project/nginx -> acr-ns/nginx.Trigger Mode
Tentukan mode pemicu. Pilih Event-driven Operations untuk menyinkronkan perubahan gambar di Harbor.
Bandwidth
Batasi lebar pita jaringan maksimum selama replikasi. Nilai default -1 menunjukkan tidak ada batasan.
Di halaman Replications, pilih aturan yang telah Anda buat pada langkah sebelumnya dan klik REPLICATE untuk mereplikasi secara manual gambar Harbor yang sudah ada ke instans Enterprise Edition. Daftar tugas replikasi menampilkan ID tugas, status (Succeeded atau Failed), mode pemicu, dan durasi setiap tugas. Saat status tugas berubah menjadi Succeeded, gambar telah direplikasi. Perubahan selanjutnya pada repository Harbor akan direplikasi ke instans Enterprise Edition berdasarkan event.
Konfigurasikan nama domain kustom untuk pemulihan bencana geo
ACR Enterprise Edition mendukung penambahan nama domain kustom dan sertifikat SSL ke instans. Nama domain kustom tersebut kemudian memungkinkan akses HTTPS ke instans.
Pilih salah satu solusi pemulihan bencana berikut berdasarkan lingkungan jaringan Anda.
Kasus penggunaan 1: Harbor dideploy di Alibaba Cloud dan aplikasi mengakses instans melalui Internet
Dalam contoh ini, instans Enterprise Edition berada di wilayah China (Hangzhou) dan registri Harbor berada di wilayah China (Zhangjiakou). Keduanya menggunakan nama domain kustom yang sama, yang dikonfigurasi dengan PrivateZone. Untuk informasi tentang cara mengonfigurasi PrivateZone, lihat Mengakses instans dengan nama domain kustom.
Tabel berikut menjelaskan informasi dasar kedua registri tersebut:
Instance ID | Public Endpoint | Associated VPC | Custom Domain Name |
ACR-A | a-registry.cn-hangzhou.cr.aliyuncs.com | vpc-aaaaa | cross-region.registry.io |
Harbor-B | - | vpc-bbbbb | cross-region.registry.io |
Jika registri Harbor di wilayah China (Zhangjiakou) mengalami kegagalan, aplikasi tidak dapat melakukan push atau pull gambar. Ubah catatan PrivateZone untuk nama domain kustom agar menarik gambar yang telah disinkronkan dari instans Enterprise Edition di wilayah lain. Lakukan langkah-langkah berikut:
Masuk ke Konsol DNS Alibaba Cloud.
Di panel navigasi kiri, klik Private Zone.
Di tab Authoritative Zone, masukkan nama domain kustom
cross-region.registry.iountuk mencari zona. Dua zona akan ditampilkan. Klik zona yang terkait dengan VPCvpc-bbbbb.Di tab Resource Record Settings, temukan catatan yang ingin diedit dan klik Modify di kolom Actions.
Di panel Modify Record, konfigurasikan parameter yang dijelaskan dalam tabel berikut. Lalu, klik Confirm.
Parameter
Deskripsi
Record Type
Pilih CNAME.
Hostname
Atur parameter ini ke @.
Record Value
Atur parameter ini ke titik akhir publik instans Enterprise Edition:
a-registry.cn-hangzhou.cr.aliyuncs.com.TTL
Pertahankan nilai default.
Kasus penggunaan 2: Harbor tidak dideploy di Alibaba Cloud dan aplikasi mengakses instans melalui Internet
Atur nama domain kustom instans Enterprise Edition menjadi nama domain yang digunakan oleh registri Harbor yang dikelola sendiri, seperti www.ha****.com. Untuk informasi selengkapnya, lihat Mengakses instans dengan nama domain kustom.
Jika registri Harbor gagal, aplikasi tidak dapat melakukan push atau pull gambar. Ubah resolusi DNS sehingga nama domain Harbor, seperti www.harbor.com, di-resolve ke Alamat IP publik instans Enterprise Edition. Aplikasi kemudian dapat mengakses instans melalui Internet untuk melakukan push dan pull gambar.
Kasus penggunaan 3: Harbor tidak dideploy di Alibaba Cloud dan aplikasi mengakses instans melalui VPC
Jika registri Harbor gagal, aplikasi tidak dapat melakukan push atau pull gambar. Dapatkan alamat IP instans Enterprise Edition. Konfigurasikan entri rute dan resolusi DNS sehingga nama domain Harbor, seperti www.harbor.com, di-resolve ke alamat IP tersebut. Aplikasi kemudian dapat mengakses instans melalui VPC untuk melakukan push dan pull gambar. Untuk informasi selengkapnya, lihat Akses instans Enterprise Edition lintas wilayah atau dari pusat data.