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
6443bisa 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-tokenCatat 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 nodesKalau berhasil, node worker baru akan muncul dengan status Ready.
Screenshot: Output kubectl get nodes — worker node baru sudah berstatus Ready
Kalau node muncul tapi statusnyaNotReady, tunggu 1–2 menit. K3s butuh waktu sebentar untuk pull image dan inisialisasi. Kalau lebih dari 5 menit belum Ready, cek log denganjournalctl -u k3s-agent -fdi server worker.
Verifikasi lebih lanjut (opsional)
Cek detail node termasuk role dan versi:
kubectl get nodes -o wideScreenshot: 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=workerSelesai
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.