Documented step-by-step rollback procedure covering code, database, and infrastructure
Why it matters
A bad production deployment without a documented rollback plan means your team is improvising under pressure during an outage — when clarity matters most. Database schema changes and infrastructure shifts cannot be undone by git revert alone. Without step-by-step rollback coverage for code, database, and infrastructure (SOC 2 A1.3, NIST CP-10), teams routinely extend incidents from minutes to hours. ISO 25010 reliability.recoverability requires demonstrable recovery procedures, not tribal knowledge.
Severity rationale
Critical because the absence of a documented rollback procedure converts every failed deployment into an extended incident where recovery time depends entirely on who is online and what they remember.
Remediation
Create DEPLOYMENT.md or RUNBOOK.md at the repo root with explicit steps for reverting code, database migrations, and infrastructure changes.
# Rollback Procedure
## Code Rollback (~5 minutes)
1. Identify the previous stable tag or commit hash
2. Redeploy: `git revert <bad-commit>` then push, or trigger re-deploy from prior tag
3. Verify health check at `/api/health` returns 200
## Database Rollback (~15 minutes)
1. Run: `npx prisma migrate resolve --rolled-back <migration-name>`
2. Restore from backup snapshot taken at deployment time if schema is incompatible
3. Confirm critical queries return expected data
## Infrastructure Rollback (~20 minutes)
1. Revert IaC change: `terraform apply -target=<resource>`
2. Confirm routing and load balancer state
Include estimated times — they set expectations during an active incident.
DetectionPro
The detection method for this pattern is part of AuditBuffet Pro.
The full method (what to look for, pass and fail conditions, and how results get reported) ships inside the Deployment Readiness Audit. The pattern definition, severity rationale, and remediation remain openly licensed under CC-BY-4.0.
External references
- iso-25010:2011 · reliability.recoverability — Recoverability (degree to which system can recover data and re-establish desired state after interruption or failure)
- nist:rev5 · CP-10 — System Recovery and Reconstitution
- soc2:2017 · A1.3 — Availability — recovery procedures
Taxons
History
- 2026-04-18·v1.0.0·Initial import from deployment-readiness·automated