Using freely available tools and only an annotated Ansible inventory file cluster-builder enables the configuration and deployment of Kubernetes clusters to Proxmox VE or local QEMU.
One command… and the cluster is deployed and re-deployed as needed.
Cluster-Builder has moved to Codeberg You probably should too.
cluster-builder uses Ansible and Bash to deploy Kubernetes kubeadm clusters to Proxmox VE. Ansible executes commands (plays) as a human operator might, making the entire cluster configuration process transparent and configurable. Easy to see what is happening, easy to diagnose problems. Easy to customize. Over the years cluster-builder has been used to deploy kubeadm k8s to VSphere/VMWare ESXi, Virtual Box, but those legacy platforms have been replaced with modern Proxmox VE and QEMU deployments.
Kubernetes clusters are configured and deployed using only an Ansible hosts file. Simple. cluster-builder is designed to deploy the virtual machines and the Kubernetes for a complete one command solution.
Deploying stable
kubeadm k8ssince1.12.
Recently updated with support for:
- Proxmox VE deployment of
Ubuntu 24.04 LTS Kubernetes 1.35 QEMUfor multi-node local workstation clusters ofUbuntu 24.04 LTS Kubernetes 1.35.
Clusters currently include:
- Canal Networking & Policy
- Sealed Secrets
- Flux CD Operator
Enabling all other package deployments via Flux CD and a FluxInstance. See the README for more details.
