gw-12 — Execution

Prerequisites

  • Go ≥ 1.25 (stdlib only, offline).

One-shot

cd gw-12-capstone-gateway-migration && bash scripts/verify.sh   # tests + rollout demos

Per-language workflow (Go)

cd gw-12-capstone-gateway-migration/src/go
go test -race -count=1 ./...        # canary analysis, ladder ramp/rollback, shadow
go run ./cmd/rolloutsim            # healthy ramp + SLO-breach rollback + shadow diff

Package map

FileWhat
rollout/rollout.gometrics, canary analysis (SLO gate), the migration ladder with auto-rollback
rollout/shadow.gozero-risk shadow/mirror validation + diff rate
cmd/rolloutsimhealthy rollout, SLO-breach rollback, and shadow validation demos

The capstone

docs/analysis.md defines the capstone exercise: take one gw-* change (e.g. gw-01 connect-per-request → gw-04 pooled+subsetted) through shadow → canary → ramp → soak, gated by gw-11 metrics, driven by gw-08 config, with a written design doc and a rehearsed rollback. See GUIDE.md for the deep dive (incl. the org/stakeholder side and NRI/OCI as a migration enabler).