Helm Integration

Kubernetes Cluster : Helm Integration #

Kubernetes menyediakan berbagai opsi untuk melakukan deployment aplikasi. Salah satu metode yang paling umum adalah menggunakan Helm package manager. Jika Kamu ingin menjalankan solusi yang populer atau cukup dikenal di dalam cluster Kubernetes, kemungkinan besar solusi tersebut sudah tersedia sebagai paket yang telah dikonfigurasi sebelumnya dan bisa diinstal hanya dalam hitungan menit. Helm memudahkan instalasi aplikasi Kubernetes dari repository jarak jauh maupun pembuatan Helm chart lokal.

Helm sudah tersedia di semua control plane node dalam klaster Kubernetes secara default dan tidak memerlukan konfigurasi tambahan. Cukup sambungkan ke node (misalnya melalui Web SSH), dan Kamu bisa langsung mulai bekerja dengan Helm. Versi Helm ini akan diperbarui secara otomatis saat cluster Kubernetes di-upgrade.

Helm bekerja berdasarkan tiga konsep utama :

• Chart adalah paket Helm yang berisi semua definisi resource yang dibutuhkan untuk menjalankan suatu aplikasi, alat, atau layanan di dalam cluster Kubernetes.
• Repository adalah tempat di mana chart dikumpulkan dan dibagikan.
• Release adalah instansi dari suatu chart yang dijalankan di cluster Kubernetes. Satu chart dapat diinstal berkali-kali di dalam cluster yang sama dengan nama release yang unik, contohnya beberapa instansi database.

Helm akan menginstal chart ke dalam Kubernetes dengan membuat release baru setiap kali instalasi dilakukan. Untuk menemukan chart baru, Kamu bisa mencari melalui repository Helm.

Dalam panduan ini, kita akan membahas seluruh tahapan utama dalam menggunakan Helm:

• mencari chart dan bekerja dengan repository
• menginstal aplikasi Helm baru
• mengelola aplikasi yang sudah ada

Finding Helm Charts #

Ada banyak solusi yang sudah dikonfigurasi sebelumnya dan bisa langsung diinstall ke dalam Kubernetes Cluster hanya dalam hitungan menit. Helm package manager memiliki pusat repositori utama yang berisi banyak solusi siap pakai. Selain itu, Kamu juga bisa menggunakan custom repository sendiri.

Helm memiliki perintah search yang cukup kuat dan bisa digunakan untuk mencari dari dua jenis sumber :

• helm search hub akan mencari di Artifact Hub (repositori Helm chart komunitas terdistribusi) yang mencantumkan Helm chart dari puluhan repositori.

Sebagai contoh, Kamu bisa menemukan semua chart WordPress yang tersedia secara publik dengan menjalankan perintah:

helm search hub wordpress

• helm search repo digunakan untuk mencari chart di repository yang sudah kamu tambahkan ke Helm client lokal (dengan helm repo add). Pencarian ini dilakukan menggunakan data lokal, jadi tidak memerlukan koneksi internet.

Helm 3 (yang digunakan sejak Kubernetes 1.18.10) tidak lagi menyertakan repositori chart bawaan. Kamu bisa menggunakan perintah helm repo untuk menambahkan, melihat, dan menghapus repository. Sebagai contoh, mari kita tambahkan Bitnami repository : 

helm repo add bitnami https://charts.bitnami.com/bitnami

Kamu bisa melihat daftar repository yang sudah dikonfigurasi di Helm dengan perintah:

helm repo list

Karena isi repositori chart sering berubah, kamu bisa memastikan Helm client-mu selalu menggunakan data terbaru dengan menjalankan:

helm repo update

Installing Helm Package #

Untuk menginstal paket baru menggunakan Helm, kamu bisa menggunakan perintah helm install. Secara sederhana, perintah ini membutuhkan dua argumen:

• {name} – nama rilis yang kamu tentukan sendiri (contoh: mywordpress)
• {chart} – nama chart yang ingin kamu install (contoh: bitnami/wordpress)

Kamu juga bisa menambahkan opsi konfigurasi chart agar aplikasinya disesuaikan dengan kebutuhanmu. Misalnya, untuk mengubah nama blog, Kamu bisa gunakan parameter –set.

Contoh perintah:

helm install --set wordpressBlogName='My Blog!' mywordpress bitnami/wordpress

Menginstal sebuah chart akan membuat objek release baru. Jika Kamu ingin agar Helm secara otomatis membuatkan nama untuk release-nya, cukup hilangkan bagian nama rilis dan tambahkan parameter –generate-name.

Selama proses instalasi, helm client akan menampilkan informasi penting seperti resource yang dibuat, status release, dan langkah konfigurasi tambahan (jika ada)

📝 NOTE
WordPress adalah solusi yang cukup kompleks karena memerlukan komponen tambahan seperti Storage dan public IP. Jika komponen-komponen ini belum disediakan saat instalasi Kubernetes Cluster, Kamu bisa menambahkannya melalui dashboard platform yang kamu gunakan.

Untuk mendapatkan URL WordPress beserta kredensial admin-nya, Kamu bisa jalankan perintah berikut di terminal :

export SERVICE_IP=$(kubectl get svc --namespace default mywordpress --template "{{ range (index .status.loadBalancer.ingress 0) }}{{ . }}{{ end }}")

printf "WordPress URL: http://$SERVICE_IP/\nWordPress Admin URL: http://$SERVICE_IP/admin\nUsername: user\nPassword: $(kubectl get secret --namespace default mywordpress -o jsonpath="{.data.wordpress-password}" | base64 --decode)\n"

Sekarang, gunakan data yang sudah Kamu dapatkan dari perintah sebelumnya untuk mengakses situs dan halaman admin WordPress.

Seperti yang Kamu lihat, nama blog kustom kita (My Blog!) yang diberikan melalui parameter –set saat instalasi Helm sudah otomatis diterapkan pada situs WordPress.

Managing Helm Applications #

Helm menyediakan berbagai perintah untuk bekerja dengan chart yang sudah terinstal. Beberapa tindakan yang dapat dilakukan antara lain:

• Upgrade rilis: memperbarui aplikasi dengan versi chart atau konfigurasi yang baru.
• Rollback (pemulihan): mengembalikan aplikasi ke versi rilis sebelumnya jika terjadi masalah.
• Cek status: melihat status dari rilis yang berjalan, termasuk informasi resource dan kondisi aplikasi.
• Cek nilai konfigurasi (values): menampilkan nilai konfigurasi yang digunakan oleh rilis tertentu.

Dengan fitur-fitur ini, Helm memudahkan pengelolaan siklus hidup aplikasi di dalam Kubernetes secara efisien dan terstruktur.

💡 TIP
Untuk informasi lebih lanjut mengenai perintah-perintah Helm, kamu bisa melihat bantuan bawaan Helm dengan perintah helm helpUntuk melihat deskripsi dari perintah tertentu beserta flag-flag opsionalnya, jalankan perintah berikut helm {command} –help

1. Untuk memantau status dari sebuah release atau membaca ulang informasi konfigurasinya, Kamu bisa menggunakan perintah berikut:

helm status mywordpress

2. Sering kali, Kamu akan menyesuaikan chart Helm agar sesuai dengan konfigurasi yang Kamu inginkan. Ini bisa dilakukan dengan memberikan nilai-nilai tertentu menggunakan dua cara saat proses instalasi atau upgrade:

• Menggunakan file YAML terpisah dengan opsi –values atau -f
  Nilai-nilai kustom dimasukkan dalam file YAML yang disediakan secara terpisah.
• Memberikan nilai langsung dari baris perintah menggunakan –set
  Nilai-nilai kustom ditentukan langsung lewat terminal, misalnya –set a=b,c=d atau –set outer.inner=value.

Kamu juga bisa menggunakan kedua opsi tersebut sekaligus. Jika ada konflik antara nilai yang diberikan, maka :

• –set memiliki prioritas lebih tinggi dibanding –values
• Jika –set digunakan lebih dari sekali, maka nilai terakhir (yang paling kanan) yang akan digunakan.

helm show values bitnami/wordpress | less

3. Kamu bisa menggunakan perintah helm upgrade untuk memperbarui release ke versi chart yang lebih baru atau mengubah konfigurasi dari release yang sudah ada. Selama proses ini, Helm akan mencoba melakukan pembaruan seminimal mungkin dengan hanya memperbarui hal-hal yang berubah sejak release terakhir.

Karena spesifikasi chart WordPress yang kita gunakan di bagian instalasi, Kamu harus menyertakan password saat melakukan upgrade release. Untuk mempermudah, mari kita simpan nilai password tersebut ke dalam variabel-variabel berikut:

export WORDPRESS_PASSWORD=$(kubectl get secret --namespace "default" mywordpress -o jsonpath="{.data.wordpress-password}" | base64 --decode)

export MARIADB_ROOT_PASSWORD=$(kubectl get secret --namespace "default" mywordpress-mariadb -o jsonpath="{.data.mariadb-root-password}" | base64 --decode)

export MARIADB_PASSWORD=$(kubectl get secret --namespace "default" mywordpress-mariadb -o jsonpath="{.data.mariadb-password}" | base64 --decode)

Sekarang, Kamu bisa menyertakan password tersebut menggunakan flag –set saat melakukan upgrade Helm. Contohnya seperti ini:

helm upgrade --set wordpressPassword=$WORDPRESS_PASSWORD,mariadb.auth.rootPassword=$MARIADB_ROOT_PASSWORD,mariadb.auth.password=$MARIADB_PASSWORD mywordpress bitnami/wordpress

4. Perintah helm get adalah alat yang berguna untuk melihat detail dari sebuah release di dalam cluster.

helm get values mywordpress

Seperti yang bisa Lamu lihat, nilai-nilai password kita tetap tersimpan meskipun setelah dilakukan upgrade.

5. Selain itu, melakukan rollback ke release sebelumnya juga sangat mudah jika terjadi kesalahan.

Perintah yang digunakan adalah helm rollback, dan membutuhkan dua parameter:

• nama release (misalnya mywordpress)
• nomor revisi yang ingin dikembalikan

Instalasi awal selalu dianggap sebagai revisi ke-1, dan setiap kali dilakukan install, upgrade, atau rollback, angka revisi akan bertambah satu.

helm history mywordpress

helm rollback mywordpress 1

6. Untuk menghapus (uninstall) sebuah release dari klaster Kubernetes, gunakan perintah berikut:

helm uninstall mywordpress

helm uninstall mywordpress --keep-history

Setelah penghapusan, kamu bisa mengecek daftar release yang masih terpasang saat ini dengan perintah: helm list

Itu dia semua dasar-dasar penggunaan Helm package manager di Kubernetes — mulai dari pencarian chart, instalasi, pengelolaan konfigurasi, upgrade, rollback, sampai uninstall. Dengan Helm, kamu bisa menyederhanakan dan menstandarkan proses deployment aplikasi di dalam cluster Kubernetes kamu.