Dorong dan tarik chart dengan Helm cm-push - Container Registry

Plugin Helm cm-push adalah ekstensi Helm yang memungkinkan Anda mendorong (push) dan menarik (pull) chart. Chart merupakan paket berisi definisi resource yang diperlukan untuk menjalankan aplikasi, tool, atau layanan di kluster Kubernetes. Untuk mendorong chart ke repositori chart remote, Anda harus terlebih dahulu menginstal plugin tersebut secara lokal menggunakan perintah helm plugin install, lalu menggunakan perintah helm push untuk mendorong chart.

Penting

Untuk menggunakan plugin Helm cm-push guna mendorong dan menarik chart melalui HTTP, Anda harus terlebih dahulu submit a ticket untuk menambahkan alamat IP klien Anda ke daftar putih internet.

Langkah 1: Konfigurasikan instans Edisi Perusahaan

Buat namespace.
1. Masuk ke Konsol Container Registry.
2. Di panel navigasi kiri, klik Instances.
3. Pada halaman Instances, klik instans Edisi Perusahaan yang ingin Anda kelola.
4. Pada halaman pengelolaan instans Edisi Perusahaan, pilih Helm Chart > Namespace.
5. Pada halaman Namespace, klik Create Namespace.
6. Pada kotak dialog Create Namespace, masukkan nama Namespace, atur Automatically Create Repository dan Default Configurations for Automatically Created Repositories, lalu klik Confirm.
Buat repositori chart.

Catatan
Jika Anda mengaktifkan Automatically Create Repository untuk namespace tersebut, Anda tidak perlu membuat repositori chart di konsol. Anda dapat langsung mendorong chart dari CLI Helm.

Repositori chart dalam instans Edisi Perusahaan harus menggunakan format <instance-name>-chart.<Region ID>.cr.aliyuncs.com/<namespace>/<chart-repository-name>. Versi chart menggunakan format <chart-name>-<version-number>. Untuk mengakses repositori melalui VPC, gunakan format <instance-name>-chart-vpc.<Region ID>.cr.aliyuncs.com/<namespace>/<chart-repository-name>.
1. Pada halaman Overview instans Edisi Perusahaan, buka bagian Component Settings dan aktifkan sakelar untuk Charts.
2. Pada halaman pengelolaan instans Edisi Perusahaan, pilih Helm Chart > Chart Repositories.
3. Pada halaman Chart repository, klik Create chart repository.
4. Pada kotak dialog Create Helm chart, pilih Namespace, atur Chart repository name dan Type, lalu klik Confirm.
Konfigurasikan kredensial akses.

Langkah-langkah berikut menunjukkan cara menetapkan password permanen:
1. Pada halaman pengelolaan instans Edisi Perusahaan, pilih Instances > Access Credentials.
2. Pada halaman Access Credentials, klik Set Password.
3. Pada kotak dialog Set Password, masukkan Password, masukkan kembali di bidang Confirm Password, lalu klik Confirm.
Konfigurasikan kebijakan kontrol akses.

Aktifkan akses dari Internet atau VPC tertentu agar Anda dapat mendorong Helm chart. Topik ini menggunakan kontrol akses melalui Internet sebagai contoh. Untuk informasi lebih lanjut tentang cara mengonfigurasi kontrol akses melalui VPC, lihat Configure access control for a VPC.
1. Pada halaman pengelolaan instans Edisi Perusahaan, pilih Helm Chart > Access Control.
2. Pada halaman Access Control, klik tab Internet.
3. Pada tab Internet, aktifkan Enable Access over Internet dan klik Add Internet Whitelist.
4. Pada kotak dialog Add Internet Whitelist, masukkan rentang alamat IP yang diizinkan mengakses instans dan deskripsi, lalu klik Confirm.
(Opsional) Aktifkan sakelar Pull from Anonymous Users.

Setelah Anda mengaktifkan sakelar Pull from Anonymous Users, Anda dapat menarik chart dari repositori chart publik tanpa login.
1. Masuk ke Konsol Container Registry.
2. Di bilah navigasi atas, pilih wilayah.
3. Di panel navigasi kiri, klik Instances.
4. Pada halaman Instances, klik instans Edisi Perusahaan yang ingin Anda kelola.
5. Pada halaman Overview, buka bagian Instance Settings di sebelah kanan dan aktifkan sakelar Pull from Anonymous Users.
6. Pada kotak dialog Tips, klik Confirm.

Langkah 2: Instal dan konfigurasikan client Helm

Unduh Helm.

Catatan
Topik ini menggunakan Helm 3.7 atau versi yang lebih baru untuk mendorong dan menarik chart. Anda dapat menjalankan perintah helm version untuk memeriksa versi klien. Topik ini menggunakan Helm 3.10.0 sebagai contoh.

Jalankan perintah berikut untuk mengekstrak paket Helm dan memindahkan file yang dapat dieksekusi ke direktori dalam PATH Anda.

# Ekstrak paket.
tar -zxvf helm-v3.10.0-rc.1-linux-amd64.tar.gz
# Pindahkan file yang dapat dieksekusi ke direktori yang ditentukan.
mv linux-amd64/helm /usr/local/bin/helm

Untuk mendorong direktori chart ke repositori Container Registry, gunakan perintah helm cm-push. Perintah ini disediakan oleh plugin Helm cm-push. Jalankan perintah berikut untuk menginstal plugin tersebut.

Catatan
Sebelum menginstal plugin Helm, jalankan perintah yum install git untuk menginstal Git.
```
helm plugin install https://github.com/AliyunContainerService/helm-acr
```

Langkah 3: Dorong dan tarik chart

Jalankan perintah berikut untuk menambahkan repositori chart remote dan memberinya alias lokal. Perintah ini memetakan alias ke URL repositori chart di namespace tertentu.
```
helm repo add <local-repository-alias> https://test9-7-chart****.cn-hangzhou.cr.aliyuncs.com/ns1/repo1 --username <username> --password <password>
```
Jalankan perintah berikut untuk mendorong chart.
```
# Buat chart secara lokal.
helm create <chart-name>
 
# Dorong direktori chart.
helm cm-push <chart-name> <local-repository-alias>
```
Pada halaman Chart repository, klik nama repositori chart target, lalu klik Versions. Pada halaman Versions, Anda dapat melihat chart yang baru saja didorong.

Jalankan perintah berikut untuk menginstal dan menarik chart.

# Perbarui indeks chart lokal dari repositori chart remote.
helm repo update
 
# Tarik chart.
helm fetch <local-repository-alias>/<chart-name> --version <chart-version>
# Atau, instal chart secara langsung.
helm install -f values.yaml <local-repository-alias>/<chart-name> --version <chart-version>