Container Registry Enterprise Edition menyimpan dan mendistribusikan artefak Open Container Initiative (OCI) kustom bersama gambar kontainer dan Helm chart. Panduan ini menjelaskan cara mendorong file lokal sebagai artefak OCI kustom ke instans Container Registry Enterprise Edition dan menariknya kembali menggunakan klien ORAS (OCI Registry As Storage).
Prasyarat
Sebelum memulai, pastikan Anda telah:
Klien ORAS yang diinstal pada mesin lokal Anda. Lihat Instalasi.
Mengaktifkan akses Internet atau mengonfigurasi daftar kontrol akses (ACL) virtual private cloud (VPC) untuk instans Container Registry Enterprise Edition Anda. Panduan ini menggunakan akses Internet. Lihat Configure access over the Internet
Kata sandi logon untuk instans Container Registry Edisi Perusahaan Anda. Jika lupa kata sandi tersebut, atur ulang dengan mengonfigurasi ulang kredensial akses. Lihat Mengonfigurasi kredensial akses untuk instans Container Registry Edisi Perusahaan.
Dorong artefak OCI kustom
Langkah 1: Atur variabel lingkungan
Atur detail registri Anda sebagai variabel lingkungan. Semua perintah berikutnya merujuk pada variabel ini, sehingga Anda hanya perlu memperbaruinya sekali.
REGISTRY=<instance-name>-registry.cn-<region>.cr.aliyuncs.com
NAMESPACE=<namespace>
REPO=<image-repository>
TAG=<artifact-version>
IMAGE=$REGISTRY/$NAMESPACE/$REPO:$TAGGanti placeholder dengan nilai aktual Anda:
| Placeholder | Deskripsi | Contoh |
|---|---|---|
<instance-name> | Nama instans Edisi Perusahaan Anda | my-registry |
<region> | Wilayah tempat instans dideploy | hangzhou |
<namespace> | Namespace dalam instans Anda | my-namespace |
<image-repository> | Nama repository image | my-artifacts |
<artifact-version> | Tag versi untuk artefak | v1.0 |
Langkah 2: Masuk ke instans
oras login --username=<username> $REGISTRYMasukkan kata sandi logon Anda saat diminta. Login yang berhasil akan menampilkan:
login succeededLangkah 3: Buat artefak lokal
Buat file contoh untuk digunakan sebagai artefak:
echo "hello world" > artifact.txtLangkah 4: Dorong artefak
Dorong file ke instans Anda menggunakan variabel $IMAGE yang telah ditetapkan sebelumnya:
oras push $IMAGE \
--manifest-config /dev/null:application/vnd.customized.artifact.config \
./artifact.txtFlag --manifest-config mengatur tipe media artefak menjadi application/vnd.customized.artifact.config, yang membedakan artefak kustom ini dari gambar kontainer standar (yang menggunakan application/vnd.oci.image.config.v1+json). Argumen ./artifact.txt menentukan file lokal yang akan diunggah.
Dorongan yang berhasil menghasilkan output serupa dengan:
Uploading a948904f2f0f artifact.txt
Uploaded a948904f2f0f artifact.txt
Pushed [registry] <instance-name>-registry.cn-<region>.cr.aliyuncs.com/<namespace>/<image-repository>:<artifact-version>
Digest: sha256:...Tarik artefak OCI kustom
Langkah 1: Atur variabel lingkungan
Jika Anda berada dalam sesi shell baru, atur ulang variabel lingkungan:
REGISTRY=<instance-name>-registry.cn-<region>.cr.aliyuncs.com
NAMESPACE=<namespace>
REPO=<image-repository>
TAG=<artifact-version>
IMAGE=$REGISTRY/$NAMESPACE/$REPO:$TAGLangkah 2: Masuk ke instans
oras login --username=<username> $REGISTRYLangkah 3: Tarik artefak
Hapus salinan lokal terlebih dahulu untuk memastikan penarikan mengambil file dari registri:
rm -f artifact.txt
oras pull $IMAGELangkah 4: Verifikasi artefak
cat artifact.txtJika penarikan berhasil, output-nya adalah:
hello world