proxmox-talos-opentofu

Proof of concept project using OpenTofu to install a Kubernetes cluster on a Proxmox hypervisor using Talos Linux.

Requirements

You need to have installed on your local machine:

• OpenTofu
• kubectl (for testing and cluster interaction)

Provisioning

The project is grouped in two modules:

• proxmox: provisioning of virtual machines, operating systems and Kubernetes cluster
• kubernetes: provisioning of Kubernetes cluster resources

So you want first to provision the Proxmox part: create a credentials.auto.tfvars file based on the example.

cd proxmox
tofu init
tofu plan
tofu apply

You can then grab the kube config file for Kubernetes provisioning like so:

tofu output kubeconfig

and put its contents into your ~/.kube/config.

Test if your cluster access works by listing the nodes:

kubectl get nodes

Secondly, you can provision the Resources inside the Kubernetes cluster:

cd kubernetes
tofu init
tofu plan
tofu apply

Information Sources

• Talos Linux documentation
• Talos Linux Image Factory
• Terraform providers/modules
  • terraform-provider-proxmox
  • terraform-provider-talos