A Terraform/OpenTofu project to provision a local Kubernetes cluster on KVM virtualization, using libvirt for infrastructure management and cloud-init for node configuration.

Infrastructure as Code: Full cluster definition using OpenTofu

• n Control Plane nodes (10.0.0.*)
• n Worker nodes (10.0.0.*)

• kubeadm 1.28.15
• kubectl 1.28.15
• kubelet 1.28.15

• SSH key authentication
• Swap disabled
• Containerd runtime

├── cloud_init.tf       # Cloud-init disk resource
├── domains.tf          # VM definitions (control plane/workers)
├── network.tf          # Kubernetes network configuration
├── main.tf             # Provider configuration
└── cloud_init.yml      # Base node configuration

• install kvm
• install mkisofs
• setup security_driver="none" on /etc/libvirt/qemu.conf

$ make init && make apply

$ make destroy

$ ssh [email protected].*

1. Scale Nodes:

# domains.tf
locals {
  control_plane_nodes = 3  # ← Modify node counts
  worker_nodes        = 3
}

2. Update Kubernetes Version:

# cloud_init.yml
apt-get install -y kubelet=1.29.0-1.1 kubeadm=1.29.0-1.1 kubectl=1.29.0-1.1

Released under The Unlicense - completely free for any use.

See CHANGELOG.md for version history and notable changes.