---
type: template
domain: product
role: Release·운영
status: active
last-reviewed: 2026-07-27
---

# 배포·마이그레이션 계획

> 이관·배포와 데이터 변경을 시간순 실행 단계, 중단점, 검증 증거로 바꾼다. 발주사 운영 환경에서의 실행은 유지보수 창·현업 업무 시간과의 충돌부터 확인한다.

## 실행 조건

| 항목 | 작성 |
|---|---|
| 릴리즈·artifact | |
| 환경·리전 | |
| 유지보수 창 (발주사 합의) | |
| 실행 Owner / 관찰자 | |
| 사람 이관 승인 링크 | |
| 예상 시간·최대 허용 시간 | |

## 배포 단계

| 순서 | 단계·대상 | 실행자 | 시작 조건 | 검증·증거 | 중단 조건 | 예상 시간 |
|---:|---|---|---|---|---|---|
| 1 | 사전 백업·스냅샷 확인 | | | | | |
| 2 | 점진 배포·flag | | | | | |
| 3 | 스모크 검증 | | | | | |
| 4 | 트래픽·사용자 확대 | | | | | |
| 5 | 완료 확인 | | | | | |

## 데이터·스키마 마이그레이션

| 변경 ID | script·버전 | 호환 전략 | dry-run·백업 | 잠금·용량 영향 | 적용 검증 | 되돌림 |
|---|---|---|---|---|---|---|
| MIG-001 | | Expand / Migrate / Contract | | | | |

기존 시스템에서의 데이터 이관(migration)이 계약 범위인지 먼저 확인한다 — 범위 밖이면 CR 대상이다 ([[SI 수주와 범위 관리]] §제외 명시).

## 설정·외부 의존

| 이름 | 변경 목적 | 적용 순서 | 비밀값 저장 위치 | 확인 방법 | 복원값·Owner |
|---|---|---|---|---|---|
| | | | 값이 아닌 승인 저장소 링크 | | |

## 실행 중 기록

| 시각 | 단계 | 실제 결과 | 지표·로그 | 결정·승인 | 다음 행동 |
|---|---|---|---|---|---|
| | | | | | |

## 완료 확인

- [ ] 승인된 artifact 외 변경이 배포되지 않았다.
- [ ] 스키마와 구·신 애플리케이션 호환을 검증했다.
- [ ] 핵심 사용자 경로와 헬스체크를 실제 환경에서 확인했다.
- [ ] 배포 중 임시 권한·flag·유지보수 모드를 정리했다.

## 인계

- 다음 문서: [[04_롤백·복구 계획]]