Cara Menambah Worker Node di Kubernetes K3s

Kalau kamu sudah punya cluster K3s yang jalan dan mau scale out dengan nambah node worker baru, prosesnya sebenarnya cukup simpel. K3s memang didesain ringan, jadi proses join node pun tidak ribet. Berikut langkah-langkahnya.

Syarat sebelum mulai

Pastikan kamu sudah punya:

• Server master K3s yang sudah running
• Server baru (calon worker) dengan akses SSH
• Koneksi antara master dan worker (port 6443 bisa diakses)

Langkah-langkah

1. Ambil token dari server master

⁠Login ke server master, lalu jalankan perintah berikut

sudo cat /var/lib/rancher/k3s/server/node-token

Catat output-nya, string panjang itulah yang dipakai worker untuk join ke cluster.
Screenshot:

2. Catat IP server master

Kalau belum tahu IP master, cek dengan:

⁠ip a | grep inet 

Pastikan IP yang dipakai bisa diakses dari server worker.

3. Install K3s agent di server worker

⁠Login ke server worker, lalu jalankan perintah install berikut. Ganti IP_MASTER dan TOKEN sesuai nilai tadi:

⁠curl -sfL https://get.k3s.io | \ K3S_URL=https://IP_MASTER:6443 \ K3S_TOKEN=TOKEN sh -

⁠Screenshot: Proses install K3s agent berjalan di server worker

4. Verifikasi node sudah join

⁠Kembali ke server master, cek status semua node:

⁠kubectl get nodes

⁠Kalau berhasil, node worker baru akan muncul dengan status Ready.
Screenshot: Output kubectl get nodes — worker node baru sudah berstatus Ready

Kalau node muncul tapi statusnya NotReady, tunggu 1–2 menit. K3s butuh waktu sebentar untuk pull image dan inisialisasi. Kalau lebih dari 5 menit belum Ready, cek log dengan journalctl -u k3s-agent -f di server worker.

Verifikasi lebih lanjut (opsional)

Cek detail node termasuk role dan versi:

kubectl get nodes -o wide

Screenshot: Output kubectl get nodes -o wide dengan info IP dan versi node

Kalau mau beri label khusus ke worker node:

kubectl label node NAMA_NODE node-role.kubernetes.io/worker=worker

Selesai

Worker baru sudah masuk cluster dan siap menerima workload. Proses ini bisa diulang untuk node berikutnya, cukup jalankan perintah install agent yang sama di server berbeda, token-nya tetap sama.