Files
Noel Sabia e022c30527 feat(okf): run on full Kubernetes with FreeLens for admin
k3s is out. The cluster is upstream Kubernetes installed with kubeadm:
containerd, single control-plane etcd, Calico for NetworkPolicy.

- add the cluster decision and the FreeLens decision
- move Terraform from the k3s service to kubeadm, Calico, metrics-server
  and the local-path provisioner
- budget ~900 MB for the control plane and plan a bigger machine before 0.3.0
- note kubelet failSwapOn and containerd hosts.toml
- rename 0.3.0 and commit the 0.2.0 done-when to the new stack
- update the German learning plan
2026-10-24 19:02:17 +02:00

1.8 KiB

Decisions

  • Learning contract with PreZero - 2 hours of company time per week plus evenings during a 6-month learning phase; one German one-pager per finished module; the repo goes public.
  • v1 scope - What the first public version keeps and what moves to later phases.
  • Own Caddy reverse proxy - The apex domain points straight at the home server; a Caddy reverse proxy provisioned by Terraform is the only entry, with automatic HTTPS.
  • Provision the server with Terraform - Packages, swap, kubeadm, Caddy and DNS are Terraform code; workloads inside the cluster stay with kustomize.
  • Full Kubernetes instead of k3s - kubeadm installs upstream Kubernetes with containerd, etcd and Calico; a bigger control plane is the price.
  • FreeLens as Noel's admin UI - FreeLens runs on the laptop and reaches the API through an SSH tunnel; visitors never get cluster access.
  • Static Nuxt served by the gateway - Nuxt is generated to static files and embedded in the gateway image instead of running as its own pod.
  • Own analytics tracker on SQLite - Analytics are counted by Noel's own code in the gateway and stored as daily totals in SQLite; no third-party tracker, no Postgres.
  • CI/CD on Gitea Actions - The existing Gitea instance and runner on the home server build, scan, deploy and version the project.
  • Knowledge bundle lives at the repository root - The repository root is the OKF bundle root; any other markdown file there needs frontmatter to stay conformant.

Open

  • Open questions - Decisions still to make, with the release that needs each answer.