Homelab

Prerequisites

1. A user provisioned in proxmox
2. An api token provisioned in proxmox
3. NFS for storing our ISO's (nfs in proxmox)
4. A Github Personal Access Token (PAT) for authenticating with fluxcd
   • Should be able to read/write the repository
5. An age secret stored at ~/.config/sops/age/keys.agekey

Quickstart

1. Configure terraform

Create a terraform/terraform.tfvars:

pm_api_url="https://proxmox:8006/api2/json"
pm_api_token_id="token-n-smokin"
pm_api_token_secret="secret-secrets-are-no-fun"


github_token = "github_pat_qqq"
github_user = "urnamehere"

2. Create the cluster

Create and bootstrap an environment via terraform!

cd terraform
terraform init

# live más
terraform apply -auto-approve

Upgrader? I hardly know her!

1. Upgrade Talos OS

First, we want to upgrade talos os.

# get internal-ip addresses of all nodes in the cluster
kubectl get nodes -o wide

# recommended to do this manual, what are we crazy? Get {NODE} from the above list, boss
talosctl upgrade --nodes {NODE} \
      --image ghcr.io/siderolabs/installer:v1.9.1

See: Upgrading Talos

2. Upgrade K8s

Once we've upgraded talos, we can upgrade k8s.

First we need to ensure that our talos client matches the talos server version, otherwise the k8s target versio may not exist. To resolve this, we can simply rebuild our developer environment without the build cache.

If we rebuilt the developer environment, we may need to re-hydrate our talosconfig and kubeconfig:

# live más-er
terraform apply -auto-approve

Finally, we can upgrade k8s:

# verify the client version
talosctl version

# upgrade k8s, only the control plane node is needed
# use --dry-run to see what's up
talosctl --nodes {CONTROL_PLANE_NODE} upgrade-k8s --to 1.32.0

See: Upgrading K8s

---

Appendices

Random things that have caused me suffering:

• Configure NFS With Proxmox
• Cloudflare Tunnels

Terraform Docs for Nerds

• Main Module
  • Create Node
  • Talos Image
• Flux Info