데이터·시스템 이관 계획서 작성법과 템플릿

이관은 범위를 먼저 자른다

이관 계획의 첫 줄은 “무엇을 옮기는가”가 아니라 “무엇을 옮기지 않는가”여야 합니다. 옮기지 않는 데이터, 이관 중에도 계속 돌아야 하는 기능을 먼저 정하면 일정이 현실적으로 보입니다.

광고 노출 데이터처럼 트래픽이 큰 경우, 이관은 데이터를 한 번에 옮기는 작업이 아니라 파티션 단위로 나눠 옮기는 작업입니다. 우아한형제들은 수천만 건 규모의 광고 노출 트래픽을 무중단으로 파티셔닝하며 이관했습니다.

이중 쓰기 기간을 계획에 넣기

새 저장소와 기존 저장소에 함께 쓰는 기간이 있어야 검증이 가능합니다. 결제 잔액처럼 일관성이 중요한 데이터는 이 기간과 비교 방법을 계획의 중심에 둬야 합니다. 메루카리는 강한 일관성을 지키면서 무중단으로 잔액 시스템을 옮기는 설계를 공개했습니다.

규모가 크면 단계를 더 잘게 나누기

공통 저장소의 규모가 커지면 한 번에 옮기지 않고 단위를 나눕니다. 깃허브는 에이전트 트래픽 확장을 위해 Git 인프라를 클라우드로 옮긴 사례를 공유합니다. 트래픽 규모가 전 세계 Git 트래픽의 절반이라는 점이 계획의 출발점이 됩니다.

모노레포 도구 전환의 검증

빌드 도구나 런타임을 함께 바꾸는 이관은 검증 항목이 많습니다. 컬리는 모노레포의 Nx를 메이저 버전 여러 단계 올리면서 Bun 환경까지 바꿨습니다. 이런 경우 계획에는 빌드 결과 비교와 실행 환경 비교를 각각 넣습니다.

템플릿(복사용)

## 1. 이관 범위

- 옮길 데이터(또는 시스템)와 제외 항목
- 이관 중에도 유지해야 하는 것

## 2. 단계

| 단계 | 할 일 | 끝났다고 볼 조건 |
|---|---|---|
| 준비 | | |
| 이중 쓰기 | | |
| 검증 | | |
| 전환 | | |
| 정리 | | |

## 3. 검증 방법

- 비교 대상, 샘플링 방식, 허용 오차

## 4. 롤백 조건

- 되돌릴 지표와 임계값, 되돌리는 절차

## 5. 담당과 일정

- 담당자, 확인할 사람