스키마 변경을 각 앱 컨테이너의 시작 과정에서 실행하는 대신 명시적인 배포 단계 하나로 실행하면 중복 데이터베이스 마이그레이션을 더 쉽게 방지할 수 있습니다.
예방을 위한 설계에서는 마이그레이션의 실행 주체, 자격 증명 세트, 완료 신호를 각각 하나씩 두고 새 복제본이 트래픽을 처리하기 전에 완료 신호를 확인합니다. 웹 및 워커 컨테이너는 스키마 변경 권한 없이도 재시작할 수 있게 하고, 마이그레이션 작업이 성공할 때까지 롤아웃이 기다리게 하며, 기존 앱 버전과 새 앱 버전이 잠시 공존할 수 있도록 스키마 변경을 설계하세요. 이렇게 하면 모든 복제본이 같은 마이그레이션 이력을 먼저 확인하기를 바라는 데 그치지 않고 경합 상태 자체를 없앨 수 있습니다.
일반적인 앱 시작 과정에서 마이그레이션 명령 제거
이미지 엔트리포인트, Compose 명령, 워커 명령, 상태 확인 래퍼, 배포 스크립트에서 자동 마이그레이션 호출을 확인하세요. 재시작이 의도적으로 선택한 마이그레이션 단계가 아닌 한, 스키마를 변경하지 않고도 애플리케이션을 재시작할 수 있어야 합니다.
Octopus의 배포 관련 글에서는 마이그레이션이 모든 마이크로서비스 프로세스 시작에 묶이는 대신 별도의 수명 주기를 가져야 한다고 설명합니다.
필요한 곳에서 마이그레이션 바이너리를 사용할 수 있게 하되, 웹 엔트리포인트와 별도의 작업 양쪽에서 실행하지 마세요. 명시적인 실행 주체 하나를 두는 편이 모두 프레임워크 잠금에 의존하는 여러 시작 경로를 두는 것보다 감사하기 쉽습니다.
배포 전 마이그레이션 작업 하나 실행
릴리스와 동일한 마이그레이션 파일을 사용하는 일회성 작업을 만들고, 대상 데이터베이스가 예상 스키마 상태에 도달한 뒤에만 성공적으로 종료되게 하세요. 애플리케이션 롤아웃은 그 결과에 따라 진행되게 하세요.
최신 롤아웃 가이드에서는 모든 복제본이 시작 시 경합하는 대신 작업 하나가 롤아웃 전에 실행되는 방법을 보여 줍니다.
마이그레이션 작업을 앱 서비스처럼 확장하지 마세요. 작업에는 대상 데이터베이스별로 실행 주체 하나, 제한 시간이 있는 타임아웃, 로그, 그리고 새 앱 버전을 차단하는 명확한 실패 상태가 있어야 합니다.
마이그레이션 성공 여부에 따라 애플리케이션 시작 제어
새 웹 및 워커 컨테이너는 마이그레이션 단계가 성공을 보고할 때까지 기다리게 하되, 대기 중인 각 컨테이너가 직접 마이그레이션을 다시 실행하지 않도록 하세요. 의존 대상은 결과이지, 스키마 변경을 다시 실행하는 것이 아닙니다.
Andrew Lock의 배포 패턴은 마이그레이션 로직을 중앙에 두면서 앱 파드가 마이그레이션을 기다리도록 합니다.
소규모 홈 서버 구성에서는 전용 Compose 서비스와 제어된 배포 스크립트를 사용해 같은 원칙을 구현할 수 있습니다. 마이그레이션 실패 시 배포가 확실하게 중단될 만큼 단순한 방식으로 유지하세요.
버전이 겹치는 동안 하위 호환 스키마 변경 적용
롤링 배포 중에는 구버전과 신버전 애플리케이션이 일시적으로 하나의 데이터베이스를 함께 사용할 수 있습니다. 구버전이 사용 중인 필드를 제거하거나 이름을 변경하는 마이그레이션은 피하세요.
최근 무중단 마이그레이션 가이드에서는 파괴적인 정리보다 추가적인 스키마 작업을 먼저 적용하도록 축소 전에 확장할 것을 권장합니다.
필요한 경우 대규모 변경을 확장, 백필, 전환, 축소 단계로 나누세요. 이전 복제본이 계속 요청을 처리하는 동안 마이그레이션 작업이 새 컨테이너만 이해하는 스키마를 만들지 않아야 합니다.
마이그레이션 인증 정보를 앱 복제본에서 분리
가능하다면 일회성 마이그레이션 단계에서만 스키마 변경 권한이 있는 데이터베이스 계정을 사용하세요. 일반 앱 컨테이너에는 애플리케이션 데이터에 필요한 읽기 및 쓰기 권한만 부여하세요.
Liquibase 배포 문서에서는 통제되고 반복 가능한 변경 적용을 위해 데이터베이스 변경은 자동화에 포함해야 한다고 설명합니다.
이렇게 분리하면 앱 프로세스가 재시작되거나 복제되더라도 마이그레이션이 실수로 실행될 가능성이 줄어듭니다. 권한이 높은 인증 정보는 일반적인 장기 실행 서비스 환경이 아니라 배포용 시크릿 경로에 저장하세요.
배포에서 배치가 두 번 적용되지 않는지 확인
일회용 데이터베이스나 복원한 스냅샷에서 앱 복제본을 여러 개 시작하고 재시작한 다음 배포 명령을 다시 실행해 배포를 테스트하세요. 마이그레이션 단계에서는 기존 스키마 상태를 보고하되 이를 두 번째로 변경하지 않아야 합니다.
JetBrains는 일반 애플리케이션을 시작하기 전에 배포 단계에서 마이그레이션 실행이라는 운영 원칙을 제시합니다.
앱을 재시작해도 스키마가 변경되지 않고, 마이그레이션 실패 한 번으로 배포가 차단되며, 배포를 반복 실행해도 데이터베이스가 그대로 유지되면 예방 정책이 완성된 것입니다. 중복 실행이 이미 발생한 경우 복구 절차로 관련 ZimaSpace 문서인 중복 마이그레이션 진단을 참고하세요.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



