Deployment Runbook
Release topology
flowchart LR
P[Precheck] --> B[Build Artifact]
B --> M[Run Migration]
M --> D[Deploy App]
D --> Q[Start/Reload Queue Workers]
Q --> V[Post-deploy Verification]
Stage gates
| Gate | Must pass | Evidence |
|---|---|---|
| G1 Precheck | lockfiles reviewed, env parity confirmed | checklist + commit hash |
| G2 Build | artifact build success | build log |
| G3 Schema | migration impact approved | migration note + backup id |
| G4 Smoke | auth/reservation/coupon path green | smoke evidence |
Safe deployment sequence
- Announce deployment window.
- Confirm DB snapshot/backup.
- Deploy artifact.
- Run migrations.
- Warm cache/config.
- Reload queue workers.
- Run smoke tests.
- Record release evidence.
Rollback strategy
- Stop risky writes/feature gate if available.
- Revert artifact.
- Rollback migration only if tested-safe.
- Reconcile queue side-effects.
- Re-run smoke tests.
Docs-site deployment (Cloudflare Pages)
- Project:
example2-docs-customa - Build:
npm run build - Deploy:
wrangler pages deploy build --project-name example2-docs-customa - Expected domain:
https://example2-doc.sudharmika.com