OpenTofu templates and container images for Coder workspaces, running on a personal Kubernetes homelab cluster.
templates/kubernetes/homelab-workspace/— the Coder/Kubernetes OpenTofu template that provisions a workspace pod.images/homelab-workspace/— the Ubuntu-based container image that pod runs.
Template and image are versioned and released together; see DESIGN.md for why. Dependency versions (OpenTofu providers, image packages, GitHub Actions) are kept current mostly by Renovate.
This repo is the middle of a larger stack: the Coder control plane is deployed separately (from the homelab-ops-kubernetes-* repos), and an operator's day-to-day tooling comes from their dotfiles at provision time. See DESIGN.md for how the image, template, and those neighbours layer into one workspace environment.
- DESIGN.md — why the template and image are built the way they are: trade-offs considered, decisions made, targeted outcomes.
- TESTING.md — how to validate a change, including exercising it against the real cluster without touching production workspace data.
- CLAUDE.md — commands and conventions for working in this repo with Claude Code.
- CHANGELOG.md — generated release history (release-please).
Commit messages follow Conventional Commits, enforced by commitlint — see CLAUDE.md for the allowed scopes. Releases and publishing are fully automated from main; see DESIGN.md and TESTING.md.