Baseline: 120/120 SSE connections opened/closed, 0 errors, p95 event 1.03 s, p95 scenario 194 ms, presenter POST 82.69 ms, 2,760 events, 2,400 pings, 4m53s. Raw summary is git-ignored. Also confirm pulse.noelsabia.dev already serves Nuxt; no route switch is needed. /stage and /live remain 404 on v1.0 until v1.1 is applied.
PulseCast infra/QA
Namespace-only Kubernetes manifests, smoke tests, and the k6 SSE load test for
PulseCast. This repo never applies cluster changes by itself: the human runs the
commands in docs/deploy.md.
Layout
deploy/k8s/ web, api, ml + cloudflared Deployments and Services, ConfigMaps
deploy/examples/ example Secret shapes (placeholders only, never applied)
scripts/smoke.sh public + in-cluster smoke checks
scripts/gate1-check.sh read-only permissions/manifest/secret readiness check
scripts/check_manifests.py cluster-free manifest guardrails used by CI
.gitea/workflows/ci.yml manifest validation; no secrets, no cluster writes
k6/sse.js 120 concurrent SSE clients for 5 minutes
docs/deploy.md Gate 1 runbook and exact human checklist
docs/load-test.md load-test procedure and how to record results
docs/failure-drills.md FastAPI-down, tunnel-down, pod-restart drills
Makefile validate, build, push, deploy, smoke, load helpers
Quick start
export KUBECONFIG=/path/to/fch26-onemanarmy-sa-kubeconfig.yaml # chmod 600
make gate1-check # read-only: permissions, guardrails, dry-run, Secrets
make validate # client-side dry run only, never applies
make build # all three images
make push # after docker login to Gitea
make deploy CONFIRM=yes # human only; requires the three Secrets first
make smoke # public HTTPS + API + ML health checks
make k6-build # once: pinned k6 + SSE extension
make load # 120 SSE clients for 5 minutes
make gate1-check exits 0 when ready, 1 on a hard permission/manifest failure,
and 2 when only human prerequisites (Secrets, Deployments) are pending. It
never mutates the cluster. DNS and public HTTPS are checked separately in the
runbook and by make smoke.
Read docs/deploy.md before the first deploy. It contains the Gitea token,
docker login, hello-world push, gitea-regcred, Cloudflare Tunnel, public
hostname, and verification steps.
Gate 1 status
- Static
make gate1-check STATIC_ONLY=1/CI passes. The live check correctly flags the cluster's v1.0 images until the reviewed v1.1 branch is applied. - All three v1.1 images build and pass local manifest-equivalent runtime checks
(read-only root,
/tmptmpfs, numeric UID). There is no Dockerfile blocker. - Gitea pull is proven:
gitea-regcredexists and the hello pod pulled fromgit.noelsabia.dev/noel/hello:gate1; the Service returned HTTP 200. - Tunnel
pulsecast-gate1is active withpulseandapi-pulseroutes.pulsealready serves the v1.0 Nuxt app; no route switch remains./stageand/liveare v1.1 pages. The API hostname isapi-pulse.noelsabia.devbecause Universal SSL only covers*.noelsabia.dev. - The 120-VU v1.0 baseline passed: 120/120 connections, 0 errors, p95 event
1.03 s, p95 scenario 194 ms. Results are in
docs/load-test.md. - v1.1 images are built from the service
mainworktrees, locally checked, and pushed. The cluster still runs the previous v1.0 images until this branch is reviewed/merged and explicitly applied. - The v1.1 branch adds web control credentials, API bootstrap config, and the k6 presenter scenario; load-test results are recorded after the approved run.
CI
.gitea/workflows/ci.yml runs make gate1-check STATIC_ONLY=1 and
make validate. It uses no Secrets, pushes no images, and never mutates a
cluster. If the Gitea runner is unavailable, run the same two commands
locally; STATIC_ONLY=1 needs no kubeconfig.
Git workflow
main is integration. New work happens on a feat/<topic> branch in its own
worktree. Before every push: git fetch origin && git merge origin/main.
Never force-push main. The initial scaffold is the one bootstrap exception
committed directly to main.
Safety rules
- No Ingress, cert-manager, external-dns, Jobs, CronJobs, CRDs, Roles, RoleBindings, NetworkPolicies, or any cluster-scoped resource.
- Exposure only through the
cloudflaredDeployment. - No secrets, tokens, kubeconfig, or raw CSV in git.
- The human applies cluster mutations.
make deployrefuses to run withoutCONFIRM=yes. - Every pod sets explicit numeric
runAsUser/runAsGroup/fsGroup: web/ml10001, api/cloudflared65532. SKE rejects a non-numeric image user underrunAsNonRoot. - The tunnel uses HTTP/2 (
--protocol http2) because TCP/443 to Cloudflare is verified and UDP/7844 is not.