Files
proxmox-tofu/README.md
Max Pfeiffer 2d31e02b47 Updated docs
2025-09-18 19:21:44 +02:00

2.2 KiB

proxmox-talos-opentofu

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

Requirements

You need to have installed on your local machine:

Provisioning

The project is grouped in two modules:

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

Proxmox VE

So you want first to provision the Proxmox part: create a configuration.auto.tfvars file based on the example and edit it so it suits your needs:

cd proxmox
cope configuration.auto.tfvars.example configuration.auto.tfvars
vim configuration.auto.tfvars

Then apply the configuration using OpenTofu:

tofu init
tofu plan
tofu apply

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

tofu output kubeconfig -raw > ~/.kube/config
chmod 600 ~/.kube/config

Test if your cluster access works by listing the nodes:

kubectl get nodes

You might need to wait a bit until the cluster comes up. Proceed with the next step when all nodes are in the ready state.

Kubernetes

Secondly, you can provision the Resources inside the Kubernetes cluster. Currently, this project just installs ArgoCD in the argocd namespace in the cluster. You can then add on top of this by adding your own resources using the GitOps approach. You need to create a configuration.auto.tfvars file as well first:

cd kubernetes
cope configuration.auto.tfvars.example configuration.auto.tfvars
vim configuration.auto.tfvars

Then do the provisiong with OpenTofu:

tofu init
tofu plan
tofu apply

Information Sources