Liquibase와 Flyway의 한계를 넘는 DB 릴리스 관리 전략

Context

Liquibase와 Flyway는 스키마 변경 추적과 반복 적용에 최적화된 도구. 하지만 다중 환경 배포 과정의 이력 관리와 인증 정보 암호화 기능 부재. 서로 다른 DB 도구 간의 실행 순서 제어와 복구 전략을 위해 취약한 쉘 스크립트에 의존하는 구조.

Technical Solution

• Version Control과 Release Management의 역할을 분리하여 기존 마이그레이션 도구를 래핑하는 추상화 계층 설계
• YAML 기반의 릴리스 정의 파일을 통해 다양한 DB 엔진(SQL Server, PostgreSQL, Oracle)과 도구(Liquibase, Flyway, sqlpackage)의 실행 순서를 중앙 제어
• 런타임 시점에만 복호화되는 암호화된 연결 정보 관리 체계를 도입하여 파이프라인 로그 내 자격 증명 노출 방지
• 개별 단계별 실패 시 설정 가능한 재시도(Retry) 로직과 구조화된 릴리스 이력 기록 기능을 통한 배포 가시성 확보
• Python 기반의 단일 실행 파일 구조를 채택하여 Windows와 Linux 등 서로 다른 OS 환경에서 동일한 배포 동작 보장
• 전/후 처리 스크립트 실행 기능을 추가하여 Materialized View 갱신과 같은 DB 외적인 후속 작업의 원자적 수행 지원

Key Takeaway

단순한 버전 관리를 넘어 릴리스 관리 계층을 분리함으로써 인프라 복잡도와 상관없이 일관된 배포 파이프라인을 구축할 수 있음.