31 lines
952 B
Markdown
31 lines
952 B
Markdown
# Terraform
|
|
|
|
Provisions everything outside the cluster on `cv-control-plane`. Rebuild is
|
|
`terraform apply` plus `kubectl apply -k deploy/`.
|
|
|
|
Layout follows `OKF_CV_Website/architecture/terraform.md`:
|
|
|
|
| File | Covers |
|
|
|---|---|
|
|
| `main.tf` | packages, 2 GB swap, containerd, `kubeadm init`, Calico, metrics-server, local-path provisioner, Caddy |
|
|
| `dns.tf` | apex A record at Cloudflare |
|
|
| `variables.tf` | server IP, SSH key, domain |
|
|
| `outputs.tf` | server IP, kubeconfig path, proxy URL |
|
|
| `versions.tf` | provider requirements, pinned after `terraform init` |
|
|
|
|
Out of scope: anything inside namespace `cv`. Namespace, quota and workloads
|
|
are applied once by hand or by CI and then live in `deploy/`.
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
cp terraform.tfvars.example terraform.tfvars # fill in
|
|
export CLOUDFLARE_API_TOKEN=...
|
|
terraform init
|
|
terraform plan
|
|
terraform apply
|
|
```
|
|
|
|
State stays local and out of Git. The kubeconfig this produces stays on this
|
|
machine.
|