마이그레이션 체크리스트
마이그레이션 체크리스트 (Migration Checklist)
이 문서는 Vault 스토리지를 이전할 때(예: Consul → 통합 스토리지) 사전에 점검하고 준비해야 할 사항을 정리한 체크리스트입니다. 마이그레이션을 안전하고 성공적으로 수행하기 위한 필수 단계들을 모아둡니다.
출처: 문서
본문
마이그레이션 전 점검
마이그레이션을 시작하기 전에 다음 사항을 확인하세요.
- Vault 버전이 마이그레이션을 지원하는지 확인
- 현재 스토리지(소스)의 데이터와 설정을 전체 백업
- 대상 스토리지(통합 스토리지)에 필요한 하드웨어(디스크 성능, 용량) 충분성 확인
- 기존 봉인 상태와 봉인 해제 키가 안전하게 보관되어 있는지 확인
- 유지보수 창(maintenance window)과 가동 중지(downtime) 계획 수립
- 마이그레이션 담당자와 책임 명확화
마이그레이션 중 점검
- 소스·대상 스토리지 설정(config.hcl)이 올바른지 재검토
-
vault operator migrate실행 전 최종 스냅샷 백업 수행 - 마이그레이션 로그와 오류를 실시간 확인
- 데이터 손실 없이 이전이 완료되었는지 확인
마이그레이션 후 점검
- 새 스토리지 클러스터(통합 스토리지) 구성(join) 완료
- 리더가 정상 선출되고 상태(
vault status)가 정상인지 확인 - 시크릿·인증 메서드·정책이 정상 동작하는지 검증
- 기존 소스 스토리지가 설정에서 제거되었는지 확인
- 감사 로그와 백업 절차가 새 구성에서 동작하는지 확인
- 준비된 롤백 계획(백업 복원)을 기록·보관
주의사항
- 데이터 이전 후에는 원본을 즉시 삭제하지 말고, 일정 기간 보관해 롤백 가능성을 유지하세요.
- 마이그레이션은 환경(단일 노드/클러스터, 에디션)마다 절차가 다를 수 있으므로, 공식 문서와 엔터프라이즈 지원 가이드를 함께 참조하세요.
참고: 이 체크리스트는 일반적인 지침이며, 구체적인 단계는 버전과 구성에 따라 달라질 수 있습니다.