All Products
Search
Document Center

Container Registry:Gunakan Helm versi lebih awal dari V3.7 untuk mendorong dan menarik chart

Last Updated:Aug 21, 2026

Versi Helm sebelum V3.7 menggunakan seperangkat perintah eksperimental Open Container Initiative (OCI)—helm3 chart save, push, pull, dan export—bukan perintah helm push yang tersedia di V3.7 dan versi setelahnya. Gunakan perintah-perintah ini untuk mendorong dan menarik chart sebagai artefak OCI dalam instans Container Registry Enterprise Edition.

Prasyarat

Sebelum memulai, pastikan Anda telah memenuhi hal-hal berikut:

  • Instans Container Registry Enterprise Edition. Untuk membuatnya, lihat dokumentasi Container Registry.

  • Helm V3 terinstal. Jalankan helm3 version -c untuk memverifikasi versi Anda. Topik ini menggunakan V3.0.2.

  • Akses jaringan ke instans Edisi Perusahaan Anda melalui Internet atau virtual private cloud (VPC).

Langkah 1: Konfigurasikan instans Edisi Perusahaan Anda

Buat namespace

  1. Login ke Konsol Container Registry.

  2. Di panel navigasi sebelah kiri, klik Instances.

  3. Pada halaman Instances, klik instans Edisi Perusahaan yang ingin Anda kelola.

  4. Login ke Konsol Container Registry.

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

  6. Pada halaman Namespace, klik Create Namespace.

  7. Pada kotak dialog Create Namespace, konfigurasikan Namespace, Automatically Create Repository, dan Default Configurations for Automatically Created Repositories, lalu klik Confirm.

Buat repository image

  1. Di panel navigasi sebelah kiri, pilih Repositories > Repositories.

  2. Pada halaman Repositories, klik Create Repository.

  3. Pada langkah Repository Info, konfigurasikan Namespace, Repository Name, Repository Type, Image Version, Accelerated Image, Summary, dan Description, lalu klik Next.

  4. Pada langkah Code Source, konfigurasikan Code Source, Build Settings, dan Build Rules, lalu klik Create Repository. Tabel berikut menjelaskan parameter utama:

    Parameter

    Description

    Code Source

    Pilih sumber kode.

    Automatically Build Images When Code Changes

    Memicu build secara otomatis saat kode dikomit ke suatu branch.

    Build With Servers Deployed Outside Chinese Mainland

    Membangun image pada server di luar Tiongkok daratan dan mendorongnya ke repository di wilayah yang ditentukan. Aktifkan opsi ini jika Dockerfile Anda menarik dependensi dari situs di luar Tiongkok daratan dan koneksi lintas batas tidak stabil.

    Build Without Cache

    Memaksa tarikan ulang base image pada setiap build, yang dapat meningkatkan waktu build. Nonaktifkan opsi ini untuk menggunakan cache dan mempercepat build.

  5. Pada halaman Repositories, klik repository image yang telah Anda buat. Jika Build muncul di panel navigasi sebelah kiri halaman manajemen repository, berarti repository image tersebut telah terikat dengan repository kode sumber.

Konfigurasikan kredensial akses

Gunakan password atau token sebagai kredensial akses untuk repository image. Topik ini menggunakan password.

  1. Di panel navigasi sebelah kiri, pilih Repositories > Access Credential.

  2. Pada halaman Access Credential, klik Set Password.

  3. Pada kotak dialog Set Password, atur Password dan Confirm Password, lalu klik Confirm.

Konfigurasikan daftar kontrol akses (ACL)

Aktifkan akses Internet atau tambahkan VPC agar Anda dapat mendorong chart ke repository image. Topik ini menggunakan akses Internet. Untuk akses VPC, lihat Configure a VPC ACL.

  1. Di panel navigasi sebelah kiri, pilih Repositories > Access Control.

  2. Pada halaman Access Control, klik tab Internet.

  3. Aktifkan Enable Access over Internet, lalu klik Add Internet Whitelist.

  4. Pada kotak dialog Add Internet Whitelist, tentukan Blok CIDR dan deskripsi, lalu klik Confirm.

(Opsional) Aktifkan anonymous pull

Setelah Anda mengaktifkan anonymous pull, pengguna dapat menarik chart dari repository image publik tanpa login.

  1. Login ke Konsol Container Registry.

  2. Di bilah navigasi atas, pilih wilayah.

  3. Di panel navigasi sebelah kiri, klik Instances.

  4. Pada halaman Instances, klik instans Edisi Perusahaan yang ingin Anda kelola.

  5. Login ke Konsol Container Registry.

  6. Di bagian Instance Settings di sisi kanan halaman Overview, aktifkan Pull from Anonymous Users.

  7. Pada kotak dialog Tips, klik Confirm.

Langkah 2: Dorong dan tarik chart

Siapkan Helm

  1. Unduh Helm V3 dari situs resmi. Topik ini menggunakan V3.0.2. Jalankan perintah berikut untuk memverifikasi versi Anda:

    helm3 version -c
  2. Aktifkan fitur eksperimental OCI:

    export HELM_EXPERIMENTAL_OCI=1

Login ke instans Edisi Perusahaan

Ganti <Registry logon name> dengan nama akun Alibaba Cloud Anda, dan ganti <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com dengan titik akhir instans Anda.

helm3 registry login --username=<Registry logon name> <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com

Contoh:

helm3 registry login --username=123@188077086902**** m**-registry.cn-hangzhou.cr.aliyuncs.com

Saat diminta, masukkan password yang Anda atur di Konfigurasikan kredensial akses.

Untuk menarik chart dari repository image publik tanpa login, aktifkan Pull from Anonymous Users pada halaman Overview instans Edisi Perusahaan Anda.

Dorong chart

  1. Buat chart contoh:

    helm3 create helloworld
  2. Simpan direktori chart sebagai image bertag di repository instans Edisi Perusahaan Anda:

    helm3 chart save helloworld <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com/<Namespace name>/<Name of the image repository>:<Image tag>

    Contoh:

    helm3 chart save helloworld m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest
  3. Dorong chart ke repository instans Edisi Perusahaan Anda:

    helm3 chart push <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com/<Namespace name>/<Name of the image repository>:<Image tag>

    Contoh:

    helm3 chart push m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest

Tarik chart

  1. Tarik chart dari repository instans Edisi Perusahaan Anda:

    helm3 chart pull <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com/<Namespace name>/<Name of the image repository>:<Image tag>

    Contoh:

    helm3 chart pull m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest
  2. Ekspor chart ke direktori lokal:

    helm3 chart export <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com/<Namespace name>/<Name of the image repository>:<Image tag> -d .

    Contoh:

    helm3 chart export m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest -d .
  3. Instal chart:

    helm3 install helloworld ./helloworld