Kubernetes dengan MicroK8s di Ubuntu

Kubernetes adalah platform orchestration container yang digunakan untuk mengelola deployment aplikasi berbasis container dalam skala besar. Untuk belajar Kubernetes secara lokal dengan ringan dan mudah, saya menggunakan MicroK8s.

Pada artikel ini saya akan mendokumentasikan langkah-langkah instalasi dan konfigurasi Kubernetes menggunakan MicroK8s di Ubuntu hingga berhasil menjalankan kubectl.

1. Install MicroK8s

Pertama install MicroK8s menggunakan snap:

sudo snap install microk8s --classic

Cek apakah MicroK8s berhasil terinstall:

microk8s version

Jika muncul error permission seperti berikut:

Insufficient permissions to access MicroK8s

berarti user belum masuk ke grup microk8s.

2. Menambahkan User ke Group MicroK8s

Tambahkan user ke grup microk8s:

sudo usermod -a -G microk8s $USER

Reload group tanpa reboot:

newgrp microk8s

Kemudian cek kembali:

microk8s version

Jika berhasil akan muncul versi MicroK8s.

3. Mengecek Node Kubernetes

Untuk melihat node Kubernetes:

microk8s kubectl get nodes

Output:

NAME         STATUS   ROLES    AGE   VERSION
pauwerfull   Ready    <none>   22h   v1.34.5

Status Ready menandakan cluster Kubernetes sudah berjalan dengan baik.

4. Install kubectl

Install kubectl standalone:

sudo snap install kubectl --classic

Cek versi:

kubectl version --client

5. Error kubectl Connection Refused

Saat pertama kali menjalankan:

kubectl get nodes

muncul error:

The connection to the server localhost:8080 was refused

Hal ini terjadi karena kubectl belum memiliki konfigurasi untuk terhubung ke cluster Kubernetes.

6. Konfigurasi kubeconfig

Buat folder konfigurasi:

mkdir -p ~/.kube

Export konfigurasi dari MicroK8s:

microk8s config > ~/.kube/config

Atur permission file:

chmod 600 ~/.kube/config

7. Testing kubectl

Sekarang jalankan kembali:

kubectl get nodes

Output:

NAME         STATUS   ROLES    AGE   VERSION
pauwerfull   Ready    <none>   22h   v1.34.5

Berarti kubectl sudah berhasil terkoneksi dengan cluster Kubernetes lokal.

8. Error “No Route to Host” pada kubectl

Saat menjalankan:

kubectl get nodes

muncul error seperti berikut:

Unable to connect to the server: dial tcp 192.168.28.24:16443: connect: no route to host

Error ini biasanya terjadi karena alamat IP cluster Kubernetes berubah, tetapi file konfigurasi kubeconfig masih menggunakan IP lama.

Hal ini sering terjadi setelah:

• Restart laptop atau VM
• Perubahan jaringan
• Restart networking
• Perubahan adapter VirtualBox/VMware/WSL

Solusi Memperbaiki kubeconfig

Generate ulang konfigurasi Kubernetes:

microk8s config > ~/.kube/config

Kemudian test kembali:

kubectl get nodes

Jika berhasil maka output akan kembali normal:

NAME         STATUS   ROLES    AGE   VERSION
pauwerfull   Ready    <none>   22h   v1.34.5