--- type: Decision title: Provision the server with Terraform description: Packages, swap, kubeadm, Caddy and DNS are Terraform code; workloads inside the cluster stay with kustomize. tags: [decision, terraform, infra] status: stable generated: { by: claude-code/claude-opus-5-5, at: 2026-10-14T00:00:00Z } verified: { by: human:noel, at: 2026-10-14T00:00:00Z } --- # Decision Terraform owns everything outside Kubernetes: server packages, swap, containerd, the kubeadm control plane, Caddy (including automatic HTTPS) and the DNS record. It bootstraps the namespace and the cluster addons once; the workloads themselves stay with kustomize. # Why - The whole system becomes rebuildable from nothing: `terraform destroy` then `terraform apply`, then `kubectl apply -k deploy/`. - Infrastructure as code is a core work skill; the playground is the place to learn it on a real, cheap target. - The same files target the home server now and any cloud VM later. # Rejected | Option | Why not | |---|---| | Ansible | Fine, but Terraform also covers DNS and is the more common hire signal | | Terraform for k8s workloads | kubectl/helm already own cluster state; two owners fight | | Manual server setup | Works once, impossible to demo or recover | # Details See [terraform provisioning](/architecture/terraform.md).