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

에바 왕

IceWhale author

에바 왕 는 기술 작가 그리고 이자 ZimaSpace의 상주 장인입니다. 평생을 기술에 열정을 가진 사람으로서 홈랩과 오픈소스 소프트웨어에 열정을 가지고 있으며,복잡한 기술 개념을 쉽게 이해할 수 있는 실습 가이드로 번역하는 데 전문성을 가지고 있습니다.에바는 셀프 호스팅이 어렵지 않고 재미있어야 한다고 믿습니다. 그녀의 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 신비를 풀도록돕고 있습니다. 첫 NAS 구축부터 Docker 컨테이너 마스터링까지.

How to Restore Immich After a Failed Container Update - Zima Store Online

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

업데이트 한 번으로 애플리케이션 코드, 데이터베이스 스키마 요구 사항, 환경 변수, 연동 서비스 버전이 동시에 변경될 수 있습니다. 계속해서 latest를 가져오거나 이전 컨테이너와 새 컨테이너를 섞으면 복구 경계를 파악하기가 더 어려워집니다. 작업 전에 Compose 파일, 환경 설정, 로그, 데이터베이스, 업로드 경로를 저장한 다음 이미지 롤백과 전체 데이터베이스 및 라이브러리 복원 중 하나를 선택하세요.

실패한 상태를 동결하고 업데이트 경계 식별하기

자동 재시작을 중지하고 서버, 머신러닝, 데이터베이스, 캐시 서비스의 정확한 이미지 또는 다이제스트를 기록하세요. 다시 가져오기 전에 시작 로그와 배포 파일을 저장하세요. 성공 기준은 무엇이 변경되었는지 설명할 수 있는 것이며, 실패한다면 배포 기록이나 로컬 이미지에서 이전 버전을 식별할 때까지 복구를 중단해야 합니다.

서버가 데이터베이스에 연결하기 전에 종료되는지, 마이그레이션 중에 종료되는지, 아니면 준비 완료 상태가 된 후 종료되는지 확인하세요. 종속성 연결 오류는 네트워크, 자격 증명 또는 상태 점검 문제의 복구로 이어지며, 마이그레이션 오류는 데이터베이스가 이미 변경되었을 수 있으므로 애플리케이션 이미지만 복원하는 위험을 높입니다.

버전이 지정된 Immich 업데이트 안내에서는 릴리스 경계와 배포 파일이 중요한 이유를 보여줍니다. 이를 사용해 전환 내역을 정리하되, 롤백의 기준은 자체 로그와 백업으로 삼으세요.

먼저 마지막 정상 이미지로 완전한 롤백 시도하기

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

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

Immich v1.135.3 보고서에는 업데이트 후 발생한 특정 데이터베이스 마이그레이션 시작 실패가 기록되어 있습니다. 해당 제한된 마이그레이션 사례는 첫 번째 치명적 오류를 주의 깊게 읽어야 한다는 점을 보여줄 뿐이며, 그 사례의 명령을 다른 버전에 복사해 사용해도 된다는 의미는 아닙니다.

롤백으로 복구할 수 없을 때만 데이터베이스와 미디어 복원하기

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

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

ZimaSpace의 Immich 마이그레이션 가이드는 영구 구성 요소를 옮길 때 유용한 목록을 제공하며, 컨테이너 이미지 자체를 사진 라이브러리로 취급하지 않도록 안내합니다.

-15% OFF

ZimaBoard 2 - 당신의 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

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

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

검증이 끝날 때까지 실패한 상태와 복구된 상태에 서로 다른 라벨을 유지하세요. 복구가 이전 버전에 의존한다면 자동 이미지 가져오기를 비활성화하고 고정한 버전을 문서화하세요. 모든 중간 릴리스를 검토하고 새로 조정된 백업을 만든 후에만 업데이트를 다시 시도하세요.

새 업로드가 사라지거나, 원본이 열리지 않거나, 작업이 반복적으로 충돌하면 보존된 복구 대상으로 롤백하세요. 소스 및 대상 버전, 이미지 다이제스트, 최초의 치명적 로그, 데이터베이스 백업 타임스탬프, 스토리지 매핑을 포함해 에스컬레이션하세요. 업데이트 호환성 문제가 해결되지 않은 동안 마지막 정상 복사본을 폐기하지 마세요.