현재 상태를 보존하고 최신 릴리스가 이전 이미지에서 읽을 수 없는 방식으로 데이터베이스나 구성을 변경했는지 확인한 뒤에만 Immich를 롤백하세요.
컨테이너 이미지는 교체할 수 있지만, 영구 상태는 이미 마이그레이션됐을 수 있습니다. 업그레이드에 문제가 생기기 시작하면 자동 업데이트와 새 쓰기를 중단하고, 두 버전을 모두 기록하고, 현재 데이터베이스와 미디어를 보호한 다음, 단순 이미지 롤백과 업그레이드 전 복구 지점 복원 중 하나를 선택하세요.
실패한 업그레이드로 상태가 더 바뀌기 전에 중단하기
증거를 수집하는 동안 자동 이미지 업데이트를 비활성화하고 클라이언트에서 새 사진이 추가되지 않도록 하세요. 이전 및 새 Immich 이미지의 정확한 버전 또는 다이제스트, PostgreSQL 버전, Compose 및 환경 파일, 마운트 경로, 최초 시작 또는 마이그레이션 오류를 기록하세요.
컨테이너 롤백 경계에 관한 ZimaSpace 가이드는 중요한 차이를 설명합니다. 영구 볼륨은 이미지를 교체해도 유지되지만, 이전 애플리케이션이 볼륨 안의 데이터와 계속 호환될 때만 안전합니다.
데이터베이스를 읽을 수 있다면 현재 실패한 상태를 데이터베이스 기본 백업 방식으로 백업하고, 업그레이드 전 백업은 별도로 보존하세요. 반복적인 실험으로 어느 쪽도 덮어쓰지 마세요. 당장은 이전 버전으로 돌아가는 것이 목표라도, 나중에 다시 진행할 때 현재 복사본이 필요할 수 있습니다.
릴리스가 데이터베이스 마이그레이션 경계를 넘었는지 확인하기
업그레이드 후 처음 발생한 오류를 살펴보고, 데이터베이스 마이그레이션 전이나 진행 중, 마이그레이션 후 애플리케이션 시작 중, 또는 사용자 워크플로 중에만 문제가 발생하는지 확인하세요. 이 시점에 따라 롤백 계획이 달라집니다. 이전 이미지가 최신 릴리스에서 이미 변경된 스키마를 이해하지 못할 수 있기 때문입니다.
최근 Immich 사례에서 서비스가 업그레이드 경로를 거친 뒤 실패한 일은 지원되지 않거나 건너뛴 마이그레이션 경로가 단순한 버전 교체를 불안정하게 만들 수 있음을 보여 줍니다. 해당 논의를 사례로 삼고, 사용 중인 버전에 해당하는 정확한 마이그레이션 순서를 확인하세요.
최신 애플리케이션이 데이터베이스에 전혀 손대지 않았고 이미지 또는 런타임 호환성 문제만 있는 경우, 특정 이미지 버전으로 롤백하는 것만으로 충분할 수 있습니다. 마이그레이션이 완료됐다면 명확한 호환성 근거가 없는 한, 이전 이미지에는 업그레이드 전 데이터베이스 백업이 더 안전한 조합이라고 가정하세요.
서로 다른 시기의 데이터베이스와 런타임을 섞지 말고 일치하는 조합으로 복원하기
마지막으로 정상 작동한 애플리케이션 버전과 호환되는 배포 구성, 호환되지 않는 변경 전 시점의 데이터베이스 복구 지점을 사용해 롤백 대상을 구성하세요. 릴리스에서 미디어 파일이 문서화된 방식으로 변경되지 않았다면 미디어 트리는 그대로 유지하세요. 애플리케이션 이미지가 바뀌었다는 이유만으로 테라바이트 단위의 데이터를 다시 복사하지 마세요.
데이터베이스 호환성을 고려한 롤백 계획의 데이터베이스 롤백 관련 논의에서는 이전 코드가 더는 이해하지 못하는 스키마에 배포될 때 발생하는 일반적인 위험을 설명합니다. 컨테이너 자체가 성공적으로 시작되는지보다 이 원칙이 더 중요합니다.
검증이 끝날 때까지 모바일 클라이언트와 예약 작업이 쓰기 작업을 할 수 없도록 롤백 인스턴스를 격리된 상태로 시작하세요. 이전 버전에서 즉시 스키마 오류가 보고되면 중단하세요. 테스트를 거친 버전별 복구 절차가 없다면 유일한 데이터베이스 사본에서 마이그레이션을 수동으로 되돌리지 마세요.
정확히 검증된 이미지 버전을 고정하고 해당 설정을 재현하세요
변경될 수 있는 태그 대신 특정 버전이나 변경 불가능한 이미지 참조를 사용하세요. 마지막으로 정상 작동이 확인된 배포의 환경, 서비스 종속성, 장치 매핑, 네트워크, 포트, 리버스 프록시 대상을 복원하세요. 여러 인프라 계층을 예고 없이 바꾸는 롤백은 두 번째 사고를 일으킬 수 있습니다.
문제가 발생한 최신 이미지와 설정을 롤백 기록과 함께 보존하세요. 이렇게 하면 비호환성 문제를 파악한 뒤 통제된 방식으로 복구를 진행할 수 있습니다. 새로 생성된 모든 아티팩트를 즉시 삭제하면 실패한 상태와 정상 작동 상태를 비교하거나 테스트 환경에서 업그레이드를 재현하기 어려워질 수 있습니다.
복원된 상태에서 이전 버전의 서비스가 시작되면 클라이언트를 활성화하기 전에 로그를 확인하세요. 예상치 못한 마이그레이션 시도, 새 설치 초기화, 스토리지 마운트 누락, 권한 재설정이 없는지 확인하세요. 로그인 페이지가 표시되는 것만으로는 롤백이 의도한 데이터를 사용한다는 증거가 되지 않습니다.
원래 트리거 조건에서 이전 버전을 검증하고 이후 진행 경로를 확보하세요
대표 사용자, 오래된 자산과 최근 자산, 앨범, 공유, 검색, 통제된 새 업로드 1건, 백그라운드 작업, 데이터베이스 백업 생성, 리버스 프록시 경로를 테스트하세요. 스택을 한 번 재시작하고 동일한 마운트와 데이터베이스가 수동 개입 없이 다시 연결되는지 확인하세요.
이러한 점검을 통과할 때까지 새 업로드를 일시 중지하고, 이후 액세스를 다시 열어 일반적인 부하가 발생하는 시간대를 모니터링하세요. 사전 업그레이드 백업과 문제가 발생한 최신 상태의 백업을 모두 보존해 두세요. 호환성 문제가 파악된 뒤 격리된 사본에서 업그레이드를 다시 시도할 수 있습니다.
이전 버전에서 스키마 비호환성이 보고되거나, 확인된 데이터가 없거나, 쓰기 작업이 예상하지 못한 경로에 저장되면 롤백에 실패한 것입니다. 복구를 덧대지 말고 중단한 뒤 보존된 복구 지점을 다시 복원하세요. 정확한 버전, 마이그레이션 로그, 데이터베이스 백업 타임스탬프, Compose 변경 사항, 실패한 첫 번째 검증 단계를 첨부해 에스컬레이션하세요.
지원 및 팁
더 읽어보기

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

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

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



