Deployment Guide

Deployment Guide

CDK Deployment Flow

cd infrastructure/cdk
cdk bootstrap aws://<ACCOUNT_ID>/<REGION>
cdk deploy --all

Deployment Checklist

1. Validate AWS credentials/profile.
2. Confirm target account/region.
3. Review stack diffs.
4. Deploy in controlled order when needed.
5. Record outputs required by frontend and dependent services.

Post-Deployment

• Update frontend config/env from stack outputs.
• Run smoke tests on core APIs and auth.
• Verify dashboards and alerts for each role.

Rollback Strategy

• Prefer stack-level rollback for failed changes.
• Re-deploy last known good infrastructure commit.
• Keep migration/data-impact steps isolated and reversible.

CI/CD Notes

• Use GitHub Actions workflows in .github/workflows/.
• Gate production deployment on tests and manual approvals where required.