앱 데이터를 잃지 않고 컨테이너 이미지를 이전 버전으로 되돌릴 수 있나요?

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

영구 상태가 컨테이너 외부에 있고 이전 버전과 계속 호환된다면 앱 데이터를 잃지 않고 컨테이너 이미지를 롤백할 수 있습니다.

홈 NAS에서 이미지를 교체하면 일반적으로 애플리케이션 런타임만 다시 생성되며, 이름이 지정된 볼륨이나 바인드 마운트에는 데이터베이스, 설정, 사용자 파일이 유지됩니다. 위험한 경계는 스키마 변경입니다. 최신 이미지는 데이터베이스를 마이그레이션하거나 구성을 다시 작성해 이전 이미지에서 읽을 수 없게 만들 수 있습니다. 롤백하기 전에 현재 마운트, 이미지 식별 정보, 구성, 보안 비밀, 일관된 데이터 백업을 확보하세요.

이미지를 변경하기 전에 현재 상태를 고정하세요

자동 이미지 업데이트를 중지하고 현재 이미지 태그, 변경 불가능한 다이제스트, 컨테이너 구성, 환경 변수, 네트워크, 포트, 마운트, 재시작 정책, 상태 확인 설정을 기록하세요. Compose 파일이나 내보낸 구성은 컨테이너와 별도로 저장하세요.

NAS 컨테이너 롤백 워크플로에서는 변경되는 latest 태그에 의존하지 말고, 정상 작동이 확인된 이전 이미지를 보관할 것을 권장합니다. 복구 지점으로 사용할 수 있는 것은 해당 이미지를 실행한 구성과 함께 보관된 이전의 특정 이미지 버전입니다.

최신 버전을 중지하기 전에 애플리케이션에 일관된 데이터베이스 백업이나 스냅샷을 만드세요. 기존 볼륨이 이미 업데이트로 인한 스키마 또는 데이터 변경을 포함할 수 있으므로, 이를 롤백 복사본이라고 가정하지 마세요.

앱 데이터가 쓰기 가능 레이어 외부에 있는지 확인하세요

이름이 지정된 모든 볼륨과 바인드 마운트를 매핑한 다음, 데이터베이스, 업로드 파일, 플러그인, 인증서, 캐시 또는 구성이 컨테이너의 쓰기 가능 레이어에만 저장되어 있는지 확인하세요.

새 컨테이너가 동일한 외부 데이터 위치에 다시 연결되는 경우에만 영구 저장소가 컨테이너 교체 후에도 유지됩니다. SynoForum의 이미지 버전 워크플로는 다른 이미지로 컨테이너를 다시 생성하기 전에 볼륨 데이터가 NAS 저장소에 유지되는지 명시적으로 확인합니다.

중요한 데이터가 쓰기 가능 레이어에만 있다면 현재 컨테이너를 제거하기 전에 복사하거나 내보내세요. 이 추출은 복구 단계로 처리하고, 버전이 지정되지 않은 컨테이너를 계속 유지해야 하는 이유로 삼지 마세요.

latest를 재사용하지 말고 정확한 이전 이미지를 고정하세요

마지막으로 정상 작동한 태그나 다이제스트를 가져오거나 찾은 다음 이미지 참조만 업데이트하세요. 서비스를 다시 생성하기 전에 아키텍처, 애플리케이션 에디션, 필수 환경 변수를 확인하세요.

Compose로 관리되는 서비스를 롤백할 때는 일반적으로 실행 중인 컨테이너를 그대로 되돌리는 대신 이전에 지정한 이미지 버전으로 돌아갑니다. 실제 롤백은 Compose에 고정된 이미지 태그를 변경하고 서비스를 다시 생성하는 방식으로 진행됩니다.

정체를 알 수 없는 오래된 캐시 이미지는 사용하지 마세요. 이미지를 가져온 뒤 다이제스트를 기록해 두세요. 그래야 다시 빌드할 때 변경 가능한 동일 태그 아래에서 다른 바이너리가 조용히 선택되는 일을 막을 수 있습니다.

최신 버전에서 데이터베이스가 변경되었는지 확인

롤백 대상 버전과 현재 이미지 사이의 버전에 대한 애플리케이션 릴리스 노트와 마이그레이션 로그를 확인하세요. 되돌릴 수 없는 스키마 변경, 재작성된 구성, 암호화 키 변경 또는 플러그인 업그레이드가 있는지 살펴보세요.

애플리케이션 코드와 스키마가 호환되어야 하므로 데이터베이스 롤백은 이미지 롤백보다 어렵습니다. Octopus는 이전 버전과 새 버전의 애플리케이션이 공존하거나 전환될 수 있을 때 하위 호환되는 마이그레이션이 필요하다고 설명합니다. 따라서 버전 간 스키마 호환성이 롤백 가능 여부를 결정하는 경계가 됩니다.

이전 이미지가 마이그레이션된 데이터베이스를 읽지 못하면 이전 코드를 새 데이터에 연결하는 대신 업그레이드 전 데이터베이스 백업을 복원하세요. 롤백을 되돌려야 할 경우에 대비해 현재 데이터베이스도 별도로 보존하세요.

동일한 영구 경로를 사용해 서비스 다시 생성

검증된 동일한 명명 볼륨 또는 바인드 마운트를 유지한 채 애플리케이션 컨테이너를 중지하고 이전 이미지를 사용해 다시 생성하세요. 볼륨을 제거하는 명령이나 UI 옵션은 사용하지 마세요.

이전 버전에서 문서화된 차이가 필요한 경우가 아니라면 네트워크 이름, 서비스 별칭, 공개 포트, UID/GID 매핑, 시크릿, 리버스 프록시 대상을 일관되게 유지하세요. 잘못된 마운트로도 컨테이너가 정상 시작되면 새 빈 앱이 만들어져 데이터가 손실된 것처럼 보일 수 있습니다.

로그인하거나 백그라운드 작업을 허용하기 전에 마운트 목록과 애플리케이션 로그를 확인하세요. 앱이 새 데이터베이스를 초기화하면 즉시 중지하고, 잘못된 위치로 가져오지 말고 데이터 경로를 바로잡으세요.

롤백을 검증하고 정방향 복구 경로 유지

로그인, 데이터베이스 읽기 및 쓰기, 업로드, 예약 작업, 연동 기능, 통제된 재시작 1회를 테스트하세요. 레코드와 파일을 일부 골라 롤백 전 목록과 비교하세요.

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.