컨테이너 업데이트 실패 후 Immich 복원 방법

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

컨테이너 업데이트 실패 후 Immich를 복구하려면 현재 상태의 증거를 보존하고 모든 Immich 서비스를 마지막으로 정상 작동했던 릴리스로 고정하세요. 조율된 롤백으로 스택을 시작할 수 없는 경우에만 데이터를 복원하세요.

업데이트는 애플리케이션 코드, 데이터베이스 스키마 요구 사항, 환경 변수, 보조 서비스 버전을 한꺼번에 변경할 수 있습니다. 최신 버전을 반복해서 가져오거나 이전 컨테이너와 새 컨테이너를 혼용하면 복구 경계를 파악하기 더 어려워집니다. 조치를 취하기 전에 Compose 파일, 환경 설정, 로그, 데이터베이스, 업로드 경로를 저장한 다음 이미지 롤백과 데이터베이스 및 라이브러리 전체 복원 중 하나를 선택하세요.

실패한 상태를 동결하고 업데이트 경계를 파악하세요

자동 재시작을 중지하고 서버, 머신러닝, 데이터베이스, 캐시 서비스의 정확한 이미지 또는 다이제스트를 기록하세요. 다시 이미지를 가져오기 전에 시작 로그와 배포 파일을 저장하세요. 변경된 항목을 파악할 수 있다면 성공입니다. 그렇지 않다면 배포 이력이나 로컬 이미지로 이전 버전을 확인할 때까지 복구를 중단해야 합니다.

서버가 데이터베이스에 연결하기 전에 종료되는지, 마이그레이션 중에 종료되는지, 아니면 준비 완료 후에 종료되는지 확인하세요. 종속 서비스 연결 오류라면 네트워크, 인증 정보 또는 상태 점검을 복구해야 합니다. 마이그레이션 오류가 발생했다면 데이터베이스가 이미 변경되었을 수 있으므로 앱 이미지만 복원하는 것은 위험합니다.

버전별 Immich 업데이트 안내에서는 릴리스 경계와 배포 파일이 왜 중요한지 설명합니다. 이 안내를 활용해 전환 과정을 파악하되, 롤백 판단의 기준은 자신의 로그와 백업으로 삼으세요.

먼저 마지막으로 정상 작동했던 이미지로 완전히 롤백해 보세요

서비스 하나만 변경하지 말고, 모든 Immich 애플리케이션 이미지를 이전에 정상 작동했던 정확한 릴리스로 고정하세요. 영구 볼륨은 그대로 둔 채 영향을 받은 컨테이너를 다시 생성하세요. 스택이 정상 상태가 되고 로그에 스키마 비호환성이 표시되지 않으면 이 최소 변경 롤백은 성공한 것입니다.

기존 서버가 현재 데이터베이스 스키마를 거부하면 중단하세요. 동일한 데이터베이스에 여러 버전을 번갈아 적용하거나 마이그레이션 테이블을 직접 수정하지 마세요. 이 실패는 업데이트가 데이터 경계를 넘었음을 의미하며, 복구하려면 선택한 애플리케이션 릴리스의 타임스탬프와 일치하는 데이터베이스 백업을 사용해야 합니다.

Immich v1.135.3 보고서에는 업데이트 후 발생한 특정 데이터베이스 마이그레이션 시작 오류가 기록되어 있습니다. 이 보고서의 제한된 마이그레이션 사례는 최초 치명적 오류를 주의 깊게 살펴볼 필요성을 보여줄 뿐, 해당 사례의 명령을 다른 버전에서 그대로 실행해도 된다는 뜻은 아닙니다.

롤백으로 복구할 수 없는 경우에만 데이터베이스와 미디어 복원하기

복원 전에 실패 상태의 안전 사본을 만들거나 스토리지 스냅샷을 생성하세요. 새 복구 대상을 준비한 다음 데이터베이스 백업을 복원하고, 이에 해당하는 업로드 라이브러리와 필요한 배포 파일을 연결하세요. 타임스탬프를 맞추려는 목적으로 현재 라이브러리의 유일한 사본을 이전 사본으로 덮어쓰지 마세요.

데이터베이스 레코드와 에셋 파일은 동일한 컬렉션을 나타내야 합니다. 백업 시점이 최근 업로드보다 앞선다면 나중에 조정할 수 있도록 해당 최신 파일을 별도로 보존하세요. 마이그레이션이 완료되고, 예상한 사용자와 에셋이 표시되며, 표본으로 확인한 원본이 광범위한 파일 누락 오류 없이 열리면 복원이 통과한 것입니다.

ZimaSpace의 Immich 마이그레이션 가이드는 영구 구성 요소를 옮길 때 유용한 인벤토리를 제공합니다. 컨테이너 이미지를 사진 라이브러리 자체로 취급해서는 안 됩니다.

업데이트 재시도 전에 복구 검증하기

로그인, 타임라인 탐색, 원본 다운로드, 썸네일 생성, 스마트 검색, 얼굴 처리, 새 업로드 1건, 데이터베이스 백업 1건을 테스트하세요. 컨테이너와 호스트를 한 번씩 재시작하세요. 재시작 후에도 같은 에셋과 기능을 사용할 수 있고 마이그레이션 또는 권한 오류가 반복되지 않아야 통과입니다.

검증이 끝날 때까지 실패 상태와 복구 상태를 각각 따로 표시하세요. 복구에 이전 버전이 필요하다면 자동 이미지 풀을 비활성화하고 버전 고정 사실을 문서화하세요. 그 사이의 모든 릴리스를 검토하고 새로 전체 백업을 만든 뒤에만 업데이트를 다시 시도하세요.

새 업로드가 사라지거나, 원본을 열 수 없거나, 작업이 반복해서 충돌하면 보존된 복구 대상으로 롤백하세요. 문제를 보고할 때는 소스 및 대상 버전, 이미지 다이제스트, 최초 치명적 로그, 데이터베이스 백업 시각, 스토리지 매핑을 포함하세요. 업데이트 호환성 문제가 해결되지 않은 동안에는 마지막으로 정상 작동한 사본을 절대 폐기하지 마세요.

지원 및 팁

더 읽어보기

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.