Files
OKF_CV_Website/architecture/index.md
T
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.2 KiB

Architecture

  • System - All runtime components of the v1 site and how a request and a knockdown flow through them.
  • Chapter service - One small Go binary whose health behavior is set by the MODE env var; every life chapter runs it.
  • Gateway - The only public service; serves the static site, streams chapter states over SSE, and forwards rate-limited knockdowns.
  • Frontend - Nuxt site generated to static files and served by the gateway, with three audience layers fed by one SSE stream.
  • Server and memory budget - The CV shares a small home server with Gitea, so every workload gets a hard memory cap; the kubeadm control plane is the biggest new cost.
  • Delivery - Gitea Actions on the home server scan, build, push to the Gitea registry, deploy with kubectl, and version with release-please.
  • Terraform provisioning - Terraform rebuilds the server, containerd, the kubeadm control plane, Caddy and DNS from nothing; nothing inside the cluster.
  • In-browser language model - A tiny language model trained by Noel that runs entirely in the visitor's browser and shows its internals live.