Dorong dan tarik chart menggunakan Helm - Container Registry

Helm adalah package manager untuk Kubernetes yang digunakan untuk mengemas, mengelola, dan mendeploy aplikasi. Setelah membuat atau memperbarui chart, Anda dapat mendorongnya ke repositori Helm agar dapat digunakan oleh pihak lain.

Langkah 1: Konfigurasikan instans Edisi Perusahaan

Buat namespace.
1. Masuk 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. Pada halaman pengelolaan instans Edisi Perusahaan, pilih Helm Chart > Namespace di panel navigasi sebelah kiri.
5. Pada halaman Namespace, klik Create Namespace.
6. Pada kotak dialog Create Namespace, masukkan nama Namespace, tentukan 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 dapat melewati pembuatan repositori chart di konsol dan langsung mendorong chart dari client Anda.

Pada instans Edisi Perusahaan, alamat repositori chart menggunakan format <instance-name>-chart.<region-id>.cr.aliyuncs.com/<namespace>/<repository-name>. Versi chart menggunakan format <chart-name>-<version-number>. Untuk mengakses repositori melalui VPC, format alamatnya adalah <instance-name>-chart-vpc.<region-id>.cr.aliyuncs.com/<namespace>/<repository-name>.
1. Pada halaman Overview instans Edisi Perusahaan, pada bagian Component Settings, aktifkan sakelar Charts.
2. Pada halaman pengelolaan instans Edisi Perusahaan, pilih Helm Chart > Chart Repositories di panel navigasi sebelah kiri.
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.

Anda dapat menggunakan password tetap atau token temporary sebagai kredensial akses untuk chart Helm Anda. Contoh ini menggunakan password tetap.
1. Pada halaman pengelolaan instans Edisi Perusahaan, pilih Instances > Access Credentials di panel navigasi sebelah kiri.
2. Pada halaman Access Credentials, klik Set Password.
3. Pada kotak dialog Set Password, masukkan Password dan Confirm Password, lalu klik Confirm.
Konfigurasikan kebijakan kontrol akses.

Aktifkan akses melalui Internet atau dari VPC tertentu untuk mengunggah chart Helm. Contoh ini menunjukkan cara mengonfigurasi akses Internet. Untuk informasi lebih lanjut tentang cara mengonfigurasi kontrol akses untuk VPC, lihat Configure VPC access control.
1. Pada halaman pengelolaan instans Edisi Perusahaan, pilih Helm Chart > Access Control di panel navigasi sebelah kiri.
2. Pada halaman Access Control, klik tab Internet.
3. Pada tab Internet, aktifkan sakelar Enable Access over Internet dan klik Add Internet Whitelist.
4. Pada kotak dialog Add Internet Whitelist, masukkan blok CIDR yang diizinkan beserta deskripsinya, lalu klik Confirm.
(Opsional) Aktifkan Pull from Anonymous Users.

Setelah Anda mengaktifkan Pull from Anonymous Users, Anda dapat menarik chart publik tanpa perlu login.
1. Masuk 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. Di bagian Instance Settings di sisi kanan halaman Overview, aktifkan sakelar Pull from Anonymous Users.
6. Pada kotak dialog Tips, klik Confirm.

Langkah 2: Instal dan konfigurasikan client

Unduh versi Helm dari website resmi.

Catatan
Pastikan client Helm Anda merupakan rilis v2. Anda dapat menjalankan perintah helm version -c untuk memeriksa versi client. Langkah-langkah ini menggunakan v2.14.2 sebagai contoh.

Jalankan perintah berikut untuk mengekstrak paket Helm dan memindahkannya ke direktori yang ditentukan.

# Ekstrak paket.
tar -zxvf helm-v2.14.2-linux-amd64.tgz
# Pindahkan paket ke direktori yang ditentukan.
mv linux-amd64/helm /usr/local/bin/helm

Instal plugin Helm.
Catatan
Anda harus menginstal Git sebelum menginstal plugin Helm.

Jika Anda berada di luar Tiongkok daratan atau memiliki koneksi stabil ke GitHub, jalankan perintah berikut untuk menginstal plugin Helm.
```
helm plugin install https://github.com/AliyunContainerService/helm-acr
```
Inisialisasi lingkungan Helm.
- Jika Anda berada di node dalam kluster Container Service for Kubernetes (ACK), Tiller telah diinisialisasi secara default, sehingga Anda hanya perlu menginisialisasi client. Untuk menghindari akses ke sumber chart Google, jalankan perintah berikut:
```
helm init --client-only --skip-refresh
```
- Pada node dalam kluster Kubernetes yang dikelola sendiri, jalankan perintah berikut untuk menghindari akses ke sumber chart Google:
```
helm init --skip-refresh
```

Langkah 3: Push and pull charts

Jalankan perintah berikut untuk mengonfigurasi pemetaan repositori lokal.

Anda harus menentukan nama repositori lokal dan memetakannya ke repositori chart dalam namespace tertentu.

export HELM_REPO_USERNAME='<username-of-your-access-credential>';
export HELM_REPO_PASSWORD='<password-of-your-access-credential>';
helm repo add <local-repository-name> acr://<instance-name>-chart.<region-id>.cr.aliyuncs.com/<namespace>/<repository-name> --username ${HELM_REPO_USERNAME} --password ${HELM_REPO_PASSWORD}

Dorong chart.

Jalankan perintah berikut untuk mendorong chart.

# Buat chart secara lokal.
helm create <chart-name>
# Dorong direktori chart.
helm cm-push <chart-name> <local-repository-name>
# Atau, dorong paket chart terkompresi.
helm cm-push <chart-name>-<chart-version>.tgz <local-repository-name>

xxx# helm create chartname
Creating chartname
xxx# helm push chartname localChart
Pushing chartname-0.1.0.tgz to localChart...
Done.
xxx#

Pada halaman Chart Repository, klik nama repositori chart tersebut, lalu klik Versions. Pada halaman Versions, Anda dapat melihat chart baru tersebut.

Jalankan perintah berikut untuk menarik chart.

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