부록 A. 런북 템플릿
마이그레이션 배포·장애 대응·복구 리허설(DR Drill)·포스트모템 네 가지 런북 템플릿을 복사해 바로 쓸 수 있는 체크리스트 형태로 제공합니다.
핵심 요약
- 마이그레이션 배포·장애 대응·복구 리허설·포스트모템 네 종류의 런북 템플릿을 그대로 복사해 사용합니다.
- 배포 런북은 staging 리허설·백업 포인트·롤백 계획 사전 점검 후
migrate deploy→migrate status→ 30분 모니터링 순으로 진행합니다. - 장애 런북은 탐지 → 완화(기능 플래그·트래픽 제한) → 진단(연결·락·슬로우쿼리) → 복구 → 종료 기준 순서로 짜여 있습니다.
- DR Drill 런북은 목표 RPO/RTO를 먼저 정하고, 격리 환경에 복원해 정합성을 점검한 뒤 실제 RPO/RTO와 병목을 기록합니다.
- 포스트모템 템플릿은 분 단위 타임라인, 직접·근본 원인, 담당자·기한이 있는 액션 아이템을 포함합니다.
1) 마이그레이션 배포 런북
# Migration Deployment Runbook
## 기본 정보
- 서비스:
- 환경:
- 변경 ID:
- 담당자(IC):
- 관측 대시보드 링크:
## 사전 점검
- [ ] staging 리허설 완료
- [ ] 백업/복구 포인트 확인
- [ ] 롤백 계획 검토
- [ ] 커뮤니케이션 채널 준비
## 실행 절차
1. 읽기/쓰기 트래픽 상태 확인
2. npx prisma migrate deploy 실행
3. 상태 확인 (npx prisma migrate status)
4. 핵심 지표 30분 모니터링
## 실패 시
- [ ] 코드 롤백 판단
- [ ] DB 상태 스냅샷 캡처
- [ ] migrate resolve 필요 여부 점검
- [ ] 사고 공지 템플릿 배포2) 장애 대응 런북
# Prisma Incident Runbook
## 탐지
- 알림 유형:
- 최초 탐지 시각:
- 사용자 영향:
## 완화
- [ ] 기능 플래그 비활성화
- [ ] 트래픽 제한/큐 적재
- [ ] 비핵심 배치 중지
## 진단
- [ ] DB 연결 수/락/슬로우쿼리 확인
- [ ] 최근 배포/마이그레이션 이력 확인
- [ ] 외부 의존성 상태 확인
## 복구
- [ ] 코드 롤백 또는 패치
- [ ] 데이터 정합성 검증
- [ ] 모니터링 임계치 임시 강화
## 종료 기준
- [ ] 에러율 정상화
- [ ] 지연 시간 정상화
- [ ] 운영 승인 후 인시던트 종료3) 복구 리허설 런북
# DR Drill Runbook
## 시나리오
- 유형: 삭제 사고 | 스키마 사고 | 리전 장애
- 목표 RPO/RTO:
## 절차
1. 지정 시점 백업 선택
2. 격리 환경 복원
3. 핵심 데이터 정합성 점검
4. 애플리케이션 연결 테스트
5. 결과 기록 및 갭 분석
## 결과
- 실제 RPO:
- 실제 RTO:
- 실패/병목 포인트:
- 개선 액션:4) 포스트모템 템플릿
# Incident Postmortem
- Incident ID:
- 기간:
- 영향 요약:
## Timeline
- 09:32 탐지
- 09:35 완화 시작
- 09:48 코드 롤백 완료
- 10:20 서비스 정상화
## Root Cause
- 직접 원인:
- 근본 원인:
## What Went Well
-
## What Went Wrong
-
## Action Items
- [ ] 항목 / 담당자 / 기한