How leandrosalvas/opentofu-proxmox-kubernetes works
This repository is OpenTofu infrastructure-as-code for provisioning a Talos-based Kubernetes cluster on Proxmox VE. The main workflow builds VM images and control-plane/worker VMs, bootstraps Talos, installs Cilium, then hands worker lifecycle to Cluster API; it also configures NFS-backed dynamic storage. The README maps these phases to the modules, but no source excerpts were provided, so relationships below are limited to those documented there. The dashboard module is present in the tree, though its behavior is not described in the README.
Main entry points: main.tf OpenTofu Root · bootstrap/main.tf Talos Bootstrap · image/main.tf Talos Image · compute/main.tf VM Compute
Components 14
VM Provisioning
- OpenTofu Root
main.tf - Talos Image
modules/image/main.tf - VM Compute
modules/compute/main.tf
Cluster Foundation
- Talos Bootstrap
modules/bootstrap/main.tf - Kubernetes Cluster
Cluster Services
- Cilium Networking
modules/cilium/main.tf - Cluster API
modules/capi/main.tf - NFS Storage
modules/storage/main.tf - Kubernetes Dashboard
modules/kubernetes-dashboard/main.tf
External Infrastructure
- Proxmox VE
- Talos API
- HAProxy Load Balancer
infra/lb/haproxy-k8s-api.cfg - NFS Server
Other components
- IaC Operator
Connections 15
- IaC Operator → OpenTofu Root: runs
README.md - OpenTofu Root → Talos Image: provisions
README.md - OpenTofu Root → VM Compute: provisions
README.md - OpenTofu Root → Talos Bootstrap: bootstraps
README.md - OpenTofu Root → Cilium Networking: installs
README.md - OpenTofu Root → Cluster API: installs
README.md - OpenTofu Root → NFS Storage: installs
README.md - Talos Image → Proxmox VE: imports image
README.md - VM Compute → Proxmox VE: creates VMs
README.md - Talos Bootstrap → Talos API: configures cluster
README.md - Talos Bootstrap → Kubernetes Cluster: bootstraps
README.md - Cilium Networking → Kubernetes Cluster: adds networking
README.md - HAProxy Load Balancer → Kubernetes Cluster: forwards API traffic
README.md - Cluster API → Kubernetes Cluster: manages workers
README.md - NFS Storage → NFS Server: provisions from
README.md