자체 호스팅 데이터베이스 업그레이드 가이드: 덤프, 스냅샷, 마이그레이션 및 롤백

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

안전한 방법은 네이티브 덤프, 스토리지 스냅샷, 격리된 복원 리허설, 명확히 설정된 롤백 지점을 사용한 단계적 업그레이드를 단일 명령이 아니라 관찰 가능한 검증 단계의 연속으로 다루는 것입니다.

홈 서버의 컨테이너 기반 PostgreSQL 또는 MariaDB 데이터베이스에서 현실적인 위험은 자체 호스팅 데이터베이스를 업그레이드하면서 논리 객체나 실행 가능한 롤백 경로를 잃을 수 있다는 점입니다. 현재 데이터베이스의 식별 정보와 복구 지점을 기록하고, 영향을 가장 적게 주는 판별 절차부터 시작합니다. 다른 변수를 변경하기 전에 통과 및 실패 결과를 해석하고, 스토리지가 불안정해지거나 복구 가능한 유일한 복사본이 위험에 노출될 경우 중단합니다. 아래 워크플로는 원래 워크로드가 성공적으로 작동하거나 증거가 상위 단계로 에스컬레이션해야 하는 기준에 도달한 경우에만 종료됩니다.

백업 전에 호환성과 롤백 방안 정의하기

데이터베이스 엔진과 정확한 소스 버전, 대상 버전, 애플리케이션 버전, 확장 기능 또는 플러그인, 문자 집합, 인증 규칙, 예약 작업, 허용 가능한 다운타임을 기록합니다. 애플리케이션의 업그레이드 안내도 데이터베이스 업그레이드 경로와 함께 확인합니다. 애플리케이션 마이그레이션으로 인해 이전 바이너리가 새 스키마와 호환되지 않을 수 있기 때문입니다.

메이저 버전 업그레이드에는 새 이미지에 이전 데이터 디렉터리를 마운트하는 방식이 아니라 논리 덤프 및 복원이나 지원되는 마이그레이션 도구가 필요한 경우가 많습니다. 독립적인 Compose 데이터베이스 메이저 버전 업그레이드 워크플로에서는 Compose 기반 PostgreSQL 메이저 버전 업그레이드 절차를 안내하고, 이전 컨테이너와 볼륨을 대상과 분리해 두어야 하는 이유를 설명합니다.

지금 롤백 기한과 트리거 조건을 기록합니다. 트리거 조건은 무결성 검사 실패, 역할이나 확장 기능 누락, 애플리케이션 오류, 허용할 수 없는 성능 저하입니다. 대상에서 프로덕션 쓰기가 시작되기 전까지만 롤백이 가능합니다. 단, 역방향 데이터 마이그레이션 계획을 테스트했다면 예외입니다.

서로 독립적인 복구 지점 두 개 만들기

해당하는 경우 전역 객체를 포함해 엔진 기본 논리 백업을 실행한 다음, 명령, 버전, 종료 상태, 매니페스트, 체크섬을 저장합니다. 데이터베이스 덤프 하나에 모든 서버 수준 종속성이 포함된다고 가정하지 말고 사용자, 권한, 확장 기능, 스키마, 예약 작업, 대형 객체가 포함되는지 확인합니다.

데이터베이스가 지원되는 상태인지 확인한 다음, 데이터베이스 볼륨의 일관된 스냅샷을 만들거나 데이터베이스를 중지한 상태에서 복사합니다. 논리 덤프는 이식성과 객체 수준 검토를 제공하고, 스토리지 복사본은 정확한 이전 버전으로 롤백할 수 있는 지점을 보존합니다. 어느 한쪽이 다른 쪽을 덮어쓰면 안 됩니다.

ZimaSpace 검증 체크리스트를 사용해 데이터베이스 백업 완전성 체크리스트를 확인하세요. 덤프를 읽을 수 있고, 스토리지 복구 지점을 식별할 수 있으며, 두 항목 모두 업그레이드할 볼륨 외부에 저장된 경우에만 백업 검증 관문을 통과합니다.

격리된 대상 환경에서 마이그레이션 리허설

별도 볼륨과 포트에서 대상 데이터베이스를 시작하고, 필요한 확장 기능을 설치한 다음, 논리 백업을 복원하고 모든 경고를 저장하세요. Percona의 논리 덤프 및 복원 업그레이드 경로 안내에서는 덤프 및 복원 순서와 계획된 PostgreSQL 업그레이드 경로에 맞는 도구를 사용해야 할 필요성을 강조합니다.

복원된 데이터베이스에 임시 애플리케이션 인스턴스를 연결하세요. 로그인, 읽기, 쓰기, 백그라운드 작업, 검색, 첨부 파일, 시간대, 재시작을 테스트하세요. 복원이 성공적으로 종료됐다는 결과에만 의존하지 말고 행 수와 주요 집계 값을 비교하세요.

확장 기능을 사용할 수 없거나, 데이터 정렬 변경이 해결되지 않았거나, 마이그레이션이 실패하거나, 복원 시간이 유지보수 시간을 초과하면 진행하지 마세요. 리허설을 수정하고 새 덤프를 만드세요. 대상 버전 호환성 문제를 알아내는 곳은 운영 환경이 아닙니다.

쓰기 전환 후 롤백이 가능한 상태 유지

유지보수 모드로 전환하고, 애플리케이션의 쓰기 작업과 작업을 중지한 다음, 활성 연결이 모두 종료되었는지 확인하고 최종 덤프 또는 지원되는 변경분을 생성하세요. 깨끗한 대상에 복원하고, 무결성과 객체를 검사하고, 애플리케이션 연결을 업데이트한 다음, 종속성 순서에 따라 서비스를 시작하세요.

오류율, 잠금, 작업 실행, 백업, 실제 애플리케이션 트랜잭션을 모니터링하세요. 기존 데이터베이스는 원래 볼륨과 이미지 다이제스트를 유지한 채 중지하고 읽기 전용으로 두세요. 같은 애플리케이션 ID로 두 데이터베이스가 각각 쓰기를 허용하게 해서는 안 됩니다.

애플리케이션, 기본 백업 작업, 재시작, 새 버전에서의 테스트 복원이 모두 통과한 뒤에만 성공으로 선언하세요. 쓰기 경계에 도달하기 전에 롤백 조건이 발생하면 앱을 보존된 이전 인스턴스로 되돌리세요. 새 데이터가 기록된 뒤에는 중단하고, 단순히 재시작하면 데이터가 되돌아간다고 가장하지 말고 문서화된 조정 계획을 따르세요.

지원 및 팁

더 읽어보기

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.