Files
OKF_CV_Website/architecture/index.md
T
Noel Sabia 3636053a35 docs(okf): replace Cloudflare Tunnel with own nginx reverse proxy
direction change: own nginx proxy (Terraform-installed, certbot TLS) is the only public entry; add own-proxy decision; update system, gateway SSE notes, server budget and accepted-downtime docs
2026-10-14 21:54:33 +02:00

1.1 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 2 vCPU, 4 GB server with Gitea and a small webapp, so every workload gets a hard memory cap.
  • 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, swap, k3s, nginx 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.