컨테이너 롤아웃 중 애플리케이션 시작과 데이터베이스 마이그레이션을 분리하는 방법

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

스키마 변경을 각 앱 컨테이너의 시작 과정에서 실행하는 대신 명시적인 배포 단계 하나로 실행하면 중복 데이터베이스 마이그레이션을 더 쉽게 방지할 수 있습니다.

예방을 위한 설계에서는 마이그레이션의 실행 주체, 자격 증명 세트, 완료 신호를 각각 하나씩 두고 새 복제본이 트래픽을 처리하기 전에 완료 신호를 확인합니다. 웹 및 워커 컨테이너는 스키마 변경 권한 없이도 재시작할 수 있게 하고, 마이그레이션 작업이 성공할 때까지 롤아웃이 기다리게 하며, 기존 앱 버전과 새 앱 버전이 잠시 공존할 수 있도록 스키마 변경을 설계하세요. 이렇게 하면 모든 복제본이 같은 마이그레이션 이력을 먼저 확인하기를 바라는 데 그치지 않고 경합 상태 자체를 없앨 수 있습니다.

일반적인 앱 시작 과정에서 마이그레이션 명령 제거

이미지 엔트리포인트, Compose 명령, 워커 명령, 상태 확인 래퍼, 배포 스크립트에서 자동 마이그레이션 호출을 확인하세요. 재시작이 의도적으로 선택한 마이그레이션 단계가 아닌 한, 스키마를 변경하지 않고도 애플리케이션을 재시작할 수 있어야 합니다.

Octopus의 배포 관련 글에서는 마이그레이션이 모든 마이크로서비스 프로세스 시작에 묶이는 대신 별도의 수명 주기를 가져야 한다고 설명합니다.

필요한 곳에서 마이그레이션 바이너리를 사용할 수 있게 하되, 웹 엔트리포인트와 별도의 작업 양쪽에서 실행하지 마세요. 명시적인 실행 주체 하나를 두는 편이 모두 프레임워크 잠금에 의존하는 여러 시작 경로를 두는 것보다 감사하기 쉽습니다.

배포 전 마이그레이션 작업 하나 실행

릴리스와 동일한 마이그레이션 파일을 사용하는 일회성 작업을 만들고, 대상 데이터베이스가 예상 스키마 상태에 도달한 뒤에만 성공적으로 종료되게 하세요. 애플리케이션 롤아웃은 그 결과에 따라 진행되게 하세요.

최신 롤아웃 가이드에서는 모든 복제본이 시작 시 경합하는 대신 작업 하나가 롤아웃 전에 실행되는 방법을 보여 줍니다.

마이그레이션 작업을 앱 서비스처럼 확장하지 마세요. 작업에는 대상 데이터베이스별로 실행 주체 하나, 제한 시간이 있는 타임아웃, 로그, 그리고 새 앱 버전을 차단하는 명확한 실패 상태가 있어야 합니다.

마이그레이션 성공 여부에 따라 애플리케이션 시작 제어

새 웹 및 워커 컨테이너는 마이그레이션 단계가 성공을 보고할 때까지 기다리게 하되, 대기 중인 각 컨테이너가 직접 마이그레이션을 다시 실행하지 않도록 하세요. 의존 대상은 결과이지, 스키마 변경을 다시 실행하는 것이 아닙니다.

Andrew Lock의 배포 패턴은 마이그레이션 로직을 중앙에 두면서 앱 파드가 마이그레이션을 기다리도록 합니다.

소규모 홈 서버 구성에서는 전용 Compose 서비스와 제어된 배포 스크립트를 사용해 같은 원칙을 구현할 수 있습니다. 마이그레이션 실패 시 배포가 확실하게 중단될 만큼 단순한 방식으로 유지하세요.

버전이 겹치는 동안 하위 호환 스키마 변경 적용

롤링 배포 중에는 구버전과 신버전 애플리케이션이 일시적으로 하나의 데이터베이스를 함께 사용할 수 있습니다. 구버전이 사용 중인 필드를 제거하거나 이름을 변경하는 마이그레이션은 피하세요.

최근 무중단 마이그레이션 가이드에서는 파괴적인 정리보다 추가적인 스키마 작업을 먼저 적용하도록 축소 전에 확장할 것을 권장합니다.

필요한 경우 대규모 변경을 확장, 백필, 전환, 축소 단계로 나누세요. 이전 복제본이 계속 요청을 처리하는 동안 마이그레이션 작업이 새 컨테이너만 이해하는 스키마를 만들지 않아야 합니다.

마이그레이션 인증 정보를 앱 복제본에서 분리

가능하다면 일회성 마이그레이션 단계에서만 스키마 변경 권한이 있는 데이터베이스 계정을 사용하세요. 일반 앱 컨테이너에는 애플리케이션 데이터에 필요한 읽기 및 쓰기 권한만 부여하세요.

Liquibase 배포 문서에서는 통제되고 반복 가능한 변경 적용을 위해 데이터베이스 변경은 자동화에 포함해야 한다고 설명합니다.

이렇게 분리하면 앱 프로세스가 재시작되거나 복제되더라도 마이그레이션이 실수로 실행될 가능성이 줄어듭니다. 권한이 높은 인증 정보는 일반적인 장기 실행 서비스 환경이 아니라 배포용 시크릿 경로에 저장하세요.

배포에서 배치가 두 번 적용되지 않는지 확인

일회용 데이터베이스나 복원한 스냅샷에서 앱 복제본을 여러 개 시작하고 재시작한 다음 배포 명령을 다시 실행해 배포를 테스트하세요. 마이그레이션 단계에서는 기존 스키마 상태를 보고하되 이를 두 번째로 변경하지 않아야 합니다.

JetBrains는 일반 애플리케이션을 시작하기 전에 배포 단계에서 마이그레이션 실행이라는 운영 원칙을 제시합니다.

앱을 재시작해도 스키마가 변경되지 않고, 마이그레이션 실패 한 번으로 배포가 차단되며, 배포를 반복 실행해도 데이터베이스가 그대로 유지되면 예방 정책이 완성된 것입니다. 중복 실행이 이미 발생한 경우 복구 절차로 관련 ZimaSpace 문서인 중복 마이그레이션 진단을 참고하세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.