Files
OKF_CV_Website/architecture/delivery.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.6 KiB

type, title, description, tags, status, generated
type title description tags status generated
Pipeline Delivery Gitea Actions on the home server scan, build, push to the Gitea registry, deploy with kubectl, and version with release-please.
architecture
ci
gitea
release-please
stable
by at
claude-code/claude-opus-5-5 2026-10-11T12:15:30Z

Pipeline

push to main ─► Gitea Actions (runner on the home server)
                 ├─ go test ./...
                 ├─ snyk test
                 ├─ build images: gateway (with Nuxt), chapter
                 ├─ push to the Gitea container registry
                 └─ kubectl apply -k deploy/
             ─► release-please (Gitea variant) opens a release PR; merging it tags the version

Details

  • Commits: Conventional Commits. feat: bumps minor, fix: bumps patch, docs: and chore: do not release.
  • Image tags: the git SHA, so every deploy is traceable.
  • Registry pull: the cluster needs an imagePullSecret for the Gitea registry, or /etc/containerd/certs.d/<registry>/hosts.toml if the registry is plain HTTP.
  • Runner permissions: a kubeconfig for a ServiceAccount that can only manage resources in cv.
  • Jobs are immutable: changing a completed chapter's Job spec needs a delete before apply. Rare, since finished chapters do not change.
  • Snyk: needs a SNYK_TOKEN secret in Gitea.
  • Memory: builds run on the same 4 GB server. Runner capacity 1, Node capped at 512 MB, swap as a safety net. See server budget.

Later