Gunakan cm-push Plugin untuk Dorong Helm Chart ke ACR - Container Registry

Plugin Helm cm-push (juga dikenal sebagai plugin helm-acr) memungkinkan Anda mendorong (push) dan menarik (pull) Helm chart ke dan dari repositori chart di Container Registry. Helm chart adalah kumpulan file yang menggambarkan satu set sumber daya Kubernetes terkait.

Penting

Untuk mendorong dan menarik chart melalui HTTP, atau ajukan tiket untuk menambahkan alamat IP lokal repositori chart ke daftar putih.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Instans ACR Edisi Perusahaan
Mesin Linux dengan yum tersedia (untuk menginstal Git)
Helm 3.7 atau versi lebih baru. Jalankan helm version -c untuk memeriksa versi Anda.

Langkah 1: Konfigurasikan instans Edisi Perusahaan Anda

Buat namespace

Masuk ke Konsol Container Registry.
Pada panel navigasi kiri, klik Instances.
Pada halaman Instances, klik instans Edisi Perusahaan yang ingin Anda kelola.
Pada panel navigasi kiri, pilih Helm Chart > Namespace.
Pada halaman Namespace, klik Create Namespace.
Pada kotak dialog Create Namespace, konfigurasikan Namespace, Automatically Create Repository, dan Default Configurations for Automatically Created Repositories, lalu klik Confirm.

Buat repositori chart

Jika Anda mengaktifkan Automatically Create Repository untuk namespace tersebut, Helm akan membuat repositori chart secara otomatis saat dorong pertama kali. Anda tidak perlu membuatnya terlebih dahulu di konsol.

Format URL repositori chart:

Jenis akses	Format URL
Internet	`<Instance name>-chart.<Region ID>.cr.aliyuncs.com/<Namespace>/<Chart repository name>`
Virtual private cloud (VPC)	`<Instance name>-chart-vpc.<Region ID>.cr.aliyuncs.com/<Namespace>/<Chart repository name>`

Format versi chart: <Chart name>-<Version number>

Pada halaman Overview instans Edisi Perusahaan, aktifkan Charts pada bagian Component Settings.
Pada panel navigasi kiri, pilih Helm Chart > Repositories.
Pada halaman Repositories, klik Create Repositories.
Pada kotak dialog Create Helm Chart, konfigurasikan Namespace, Repository Name, dan Type, lalu klik Confirm.

Tetapkan kredensial akses

Tetapkan password atau token temporary untuk mengautentikasi operasi Helm. Contoh ini menggunakan password.

Pada panel navigasi kiri, pilih Instances > Access Credential.
Pada halaman Access Credential, klik Set Password.
Pada kotak dialog Set Password, konfigurasikan Password dan Confirm Password, lalu klik Confirm.

Konfigurasikan kontrol akses

Aktifkan akses Internet atau akses VPC agar Helm dapat mengakses repositori chart Anda. Contoh ini mengaktifkan akses Internet. Untuk akses VPC, lihat Konfigurasikan ACL VPC.

Pada panel navigasi kiri, klik Access Control.
Pada halaman Access Control, klik tab Internet.
Aktifkan Enable Access over Internet, lalu klik Add Internet Whitelist.
Pada kotak dialog Add Internet Whitelist, tentukan Blok CIDR yang diizinkan dan catatan, lalu klik Confirm.

(Opsional) Aktifkan pull anonim

Setelah Anda mengaktifkan Pull from Anonymous Users, siapa pun dapat menarik chart dari repositori chart publik Anda tanpa harus masuk.

Masuk ke Konsol Container Registry.
Pada bilah navigasi atas, pilih wilayah.
Pada panel navigasi kiri, klik Instances.
Pada halaman Instances, klik instans Edisi Perusahaan yang ingin Anda kelola.
Pada bagian Instance Settings di halaman Overview, aktifkan Pull from Anonymous Users.
Pada kotak dialog Tips, klik OK.

Langkah 2: Instal client Helm dan plugin cm-push

Versi Helm yang didukung: Helm 3.7 atau versi lebih baru. Contoh ini menggunakan Helm 3.10.0.

Unduh Helm.

Ekstrak paket dan pindahkan binari ke PATH Anda:

tar -zxvf helm-v3.10.0-rc.1-linux-amd64.tar.gz
mv linux-amd64/helm /usr/local/bin/helm

Instal Git, yang diperlukan oleh penginstal plugin:
```
yum install git
```

Instal plugin helm-acr:

helm plugin install https://github.com/AliyunContainerService/helm-acr

Langkah 3: Dorong chart

Daftarkan repositori chart Anda sebagai alias repo lokal:

helm repo add <repo-alias> https://<instance-name>-chart.<region-id>.cr.aliyuncs.com/<namespace>/<chart-repo-name> --username <username> --password <password>

Placeholder	Deskripsi	Contoh
`<repo-alias>`	Nama lokal untuk repositori di mesin ini	`my-charts`
`<instance-name>`	Nama instans ACR Edisi Perusahaan Anda	`test9-7`
`<region-id>`	ID wilayah tempat instans ditempatkan	`cn-hangzhou`
`<namespace>`	Namespace yang Anda buat di Langkah 1	`ns1`
`<chart-repo-name>`	Nama repositori chart	`repo1`
`<username>`	Username Akun Alibaba Cloud Anda	—
`<password>`	Password yang Anda tetapkan pada kredensial akses	—

Buat grafik dan dorong.
```
# Buat kerangka chart
helm create <chart-name>

# Dorong direktori chart ke repositori yang terdaftar
helm cm-push <chart-name> <repo-alias>
```
Untuk memverifikasi proses dorong, buka Konsol Container Registry. Pada panel navigasi kiri instans Edisi Perusahaan Anda, pilih Helm Chart > Repositories. Klik nama repositori chart, lalu klik Versions untuk melihat chart yang baru saja didorong.

Langkah 4: Tarik dan instal chart

Perbarui indeks chart lokal dari repositori:
```
helm repo update
```
Tarik versi chart tertentu:
```
helm fetch <repo-alias>/<chart-name> --version <chart-version>
```
Placeholder Deskripsi Contoh
<repo-alias> Alias repo lokal yang Anda daftarkan my-charts
<chart-name> Nama chart my-app
<chart-version> Versi chart yang akan ditarik 0.1.0

Placeholder	Deskripsi	Contoh
`<repo-alias>`	Alias repo lokal yang Anda daftarkan	`my-charts`
`<chart-name>`	Nama chart	`my-app`
`<chart-version>`	Versi chart yang akan ditarik	`0.1.0`

Instal chart langsung dari repositori:

helm install -f values.yaml <repo-alias>/<chart-name> --version <chart-version>

Langkah berikutnya

Konfigurasikan ACL VPC untuk mengaktifkan akses berbasis VPC ke repositori chart Anda