55dfe8b616840cc9121a964b316d3e1ed63b32a0
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
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 validate # client-side dry run only, never applies
make deploy CONFIRM=yes # human only; requires the three Secrets first
make smoke # public HTTPS + API + ML health checks
make load # k6 SSE load test (needs the k6 SSE extension)
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.
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.
Description
Everything around k8, maybe k6 in here to build, check and verify the infrastructure
356 KiB
0 Stars
1 Watchers
0 Forks
Languages
Shell
29.5%
Python
29.2%
Makefile
23%
JavaScript
18.3%