kubelab

A local kubernetes cluster of the following shape:

• Kubernetes 1.30
• VM host: Vagrant & VirtualBox
• OS: Ubuntu 24.04 LTS (Noble Numbat)
• Cluster creation: Kubeadm
• Provisioning: Ansible
• CNI: Cilium

Prerequisites

• Vagrant (tested with 2.4.1)
• VirtualBox (tested with 7.0.16)
• Ansible (tested with 2.17.5)

The Ansible kubernetes.core collection is required for creating kubernetes resources and installing helm charts. It can be installed by running ansible-galaxy collection install kubernetes.core

Usage

Note: You may need to adjust the IP_BASE variable in ./Vagrantfile based on the host network(s) in your VirtualBox set up.

# Provision the cluster
vagrant up

# Ansible writes the kubeconfig for the cluster to ./kubeconfig. Tell kubectl to
# use this config:
export KUBECONFIG=${PWD}/kubeconfig

# View the nodes of the cluster
kubectl get nodes -o wide

NAME     STATUS   ROLES           AGE     VERSION   INTERNAL-IP     EXTERNAL-IP   OS-IMAGE           KERNEL-VERSION     CONTAINER-RUNTIME
master   Ready    control-plane   11m     v1.30.1   192.168.56.10   <none>        Ubuntu 24.04 LTS   6.8.0-31-generic   containerd://1.7.23
node1    Ready    <none>          6m18s   v1.30.1   192.168.56.11   <none>        Ubuntu 24.04 LTS   6.8.0-31-generic   containerd://1.7.23
node2    Ready    <none>          36s     v1.30.1   192.168.56.12   <none>        Ubuntu 24.04 LTS   6.8.0-31-generic   containerd://1.7.23

# Destroy the cluster
vagrant destroy -f