chore: bootstrap infra-k8 scaffold
This commit is contained in:
commit
aeee20cb7f
14 files changed
+1256
No files matched your search
@@ -0,0 +1,48 @@
|
||||
# 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
|
||||
|
||||
```text
|
||||
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
|
||||
|
||||
```bash
|
||||
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 `cloudflared` Deployment.
|
||||
- No secrets, tokens, kubeconfig, or raw CSV in git.
|
||||
- The human applies cluster mutations. `make deploy` refuses to run without
|
||||
`CONFIRM=yes`.
|
||||
Reference in new issue
Block a user