| name | shipping-checklist |
| description | Pre-deployment checklist for infrastructure changes. Use when deploying to production, launching new services, or performing staged rollouts. |
Shipping Checklist
Overview
인프라 변경을 프로덕션에 배포하기 전 수행하는 체크리스트입니다.
배포는 코드 작성보다 위험하므로, 구조화된 검증 없이 진행하지 않습니다.
When to Use
- terraform apply to prd
- 새 서비스 런칭
- 인프라 마이그레이션 완료 단계
- feature flag 활성화
- DNS 변경, 인증서 교체
적용하지 않는 경우: dev/stg 환경 변경, 태그/설명 수정.
Pre-Deploy Checklist
1. 코드 준비
2. 보안 검증
3. 롤백 계획
terraform state pull > backup-$(date +%Y%m%d-%H%M%S).tfstate
4. 모니터링 준비
5. 배포 실행
6. Post-Deploy 검증
curl -f http://endpoint/health
aws ec2 describe-instance-status --instance-ids <id>
aws ecs describe-services --cluster <cluster> --services <svc>
terraform plan
Staged Rollout
대규모 변경 시 단계별 배포:
Phase 1: Canary (1개 인스턴스/AZ)
→ 30분 관찰 → 이상 없으면 진행
Phase 2: 50% 배포
→ 1시간 관찰 → 이상 없으면 진행
Phase 3: 100% 배포
→ 모니터링 안정화 확인
Rollback Decision
| 조건 | 조치 |
|---|
| 배포 후 5분 이내 장애 | 즉시 롤백 |
| 메트릭 이상 (에러율 증가) | 즉시 롤백 |
| 부분 장애 | feature flag OFF → 조사 |
| 데이터 마이그레이션 포함 | forward fix (롤백 불가) |
Common Rationalizations
| Rationalization | Reality |
|---|
| "dev에서 됐으니 바로 prd 적용합니다" | 환경 차이가 있습니다. 체크리스트를 수행합니다. |
| "급해서 롤백 계획은 나중에 세웁니다" | 롤백 계획 없이 배포하면 장애 시 복구 시간이 배로 늘어납니다. |
| "모니터링은 배포 후 설정합니다" | 배포 시점에 모니터링이 없으면 장애를 감지할 수 없습니다. |
Red Flags
- 체크리스트 미수행 상태에서 prd apply
- 롤백 계획 없음
- state 백업 없음
- 모니터링/알림 미설정
- 단계별 검증 없이 전체 한 번에 배포
Verification
배포 완료 후:
