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

다른 이미지를 받기 전에 실패한 Plex 컨테이너와 자동 업데이트 프로그램을 중지하세요. 먼저 현재 로그와 실제 Plex 구성 경로를 보존하세요. 문제가 있는 컨테이너가 계속 스스로 교체되거나 애플리케이션 상태에 기록하지 못하게 해야 복구가 훨씬 안전합니다.

홈 NAS에서는 컨테이너 업데이트가 여러 계층에서 실패할 수 있습니다. 새 이미지가 시작되지 않을 수도 있고, 재생성된 서비스에서 볼륨이나 네트워크 설정이 사라질 수도 있으며, 새 Plex 빌드가 기존 애플리케이션 데이터를 다른 방식으로 열 수도 있습니다. 중요한 경계는 영구 Plex 구성, 특히 `/config` 아래의 데이터베이스와 메타데이터입니다. 이 워크플로는 변경하기 전에 이미지, 컨테이너 정의, 마운트, 데이터베이스를 분리한 다음, 실패한 계층 중 가장 작은 부분을 복원하고 원래 서버 ID, 라이브러리, 재생이 정상인지 확인합니다. 로그에 데이터베이스 손상이나 되돌릴 수 없는 마이그레이션이 표시되면 해당 상태의 유일한 사본에 이전 이미지를 강제로 적용하기 전에 중지하세요.

업데이트 루프를 중지하고 실패 상태 캡처하기

Plex의 자동 업데이트를 비활성화하고 빠른 재시작 루프를 중지하세요. Plex가 조정된 중지를 요구하는 데이터베이스를 다른 정상 서비스와 공유하는 경우가 아니라면, 다른 정상 서비스는 계속 실행 상태로 두세요. 목표는 전체 앱 스택을 재시작해 타임라인을 지워 버리는 것이 아니라, 실패 상태를 그대로 유지해 충분히 점검하는 것입니다.

실패한 컨테이너의 정확한 이미지 태그, 이미지 ID, 가능한 경우 다이제스트를 기록하세요. 적용된 마운트, 환경 변수, 공개 포트, 네트워크 모드, 네트워크 별칭, 장치 매핑, 그룹 추가 설정, 재시작 정책, 상태 점검 상태를 저장하세요. `latest` 같은 태그만으로는 신뢰할 수 있는 롤백 기록이 되지 않습니다. 시간이 지나면서 서로 다른 이미지 콘텐츠를 가리킬 수 있기 때문입니다.

다시 시작하기 전에 최근 로그를 내보내고, 최종 종료 코드뿐 아니라 처음 발생한 치명적 메시지를 기록하세요. 파일 누락, 권한 거부, 데이터베이스 오류, 지원되지 않는 명령, 주소 충돌은 각각 다른 복구 경로로 이어집니다. 또한 업데이트가 실행된 시점과 컨테이너가 재생성되었는지도 기록하세요. 이미지를 받는 것만으로는 기존 컨테이너가 변경되지 않지만, 재생성하면 실제 적용되는 정의가 달라질 수 있습니다.

실패를 재현할 수 있고 다음 네 가지 질문에 답할 수 있을 때 계속 진행할 준비가 된 것입니다. 어떤 이미지가 실행되었는지, 어떤 영구 경로를 사용했는지, 어떤 런타임 설정이 전달되었는지, 어떤 오류가 처음 나타났는지 확인해야 합니다. 이러한 사실이 아직 불분명하다면 이미지를 다시 받거나 재시작해도 복구가 더 안전해지지 않고 혼란만 커집니다.

Plex 구성을 컨테이너 재생성 전에 보호하기

컨테이너는 교체 가능한 것으로, Plex 구성은 영구적인 것으로 취급하세요. 핵심 상태는 일반적으로 `/config`에 마운트된 호스트 경로 또는 이름이 지정된 볼륨에 저장되며, 미디어 라이브러리는 별도의 마운트로 유지해야 합니다. 서비스를 다시 만드는 작업은 빈 디렉터리가 아니라 동일한 영구 상태에 다시 연결될 때만 위험이 낮습니다.

호스트에서, 그리고 플랫폼이 지원한다면 임시 읽기 전용 환경에서도 마운트를 검사하세요. 예상되는 데이터베이스, 기본 설정, 메타데이터, 플러그인 데이터 및 로그가 존재하는지 확인하세요. 마운트 소스, 파일 시스템, 소유자, 권한, 사용 가능한 공간, 읽기 전용으로 전환되었는지를 기록하세요. 예상 경로에 빈 디렉터리가 있다면 작업을 중단해야 한다는 경고이지, Plex가 그곳에 새 서버를 만들도록 허용해도 된다는 뜻이 아닙니다.

롤백을 테스트하기 전에 의도한 구성 경로 전체를 백업한 다음, 백업을 나열하거나 격리된 위치로 복원할 수 있는지 확인하세요. 파일 시스템이 스냅샷을 지원한다면 복구 시간을 단축할 수 있지만, 동일한 저장 장치에 장애가 발생했을 수 있는 경우 스냅샷만 유일한 복사본으로 사용해서는 안 됩니다. 서버가 검증될 때까지 장애가 발생한 상태와 마지막으로 정상 작동한 백업을 모두 보관하세요.

이전 이미지를 시작하기 위해 기본 설정 파일, 데이터베이스 파일 또는 메타데이터를 삭제하지 마세요. 구성을 일관되게 읽을 수 없거나 소유권이 불분명하거나 복사본을 검증할 수 없다면 즉시 스토리지 또는 데이터베이스 복구로 진행하세요. 신뢰할 수 없는 상태 소스는 컨테이너를 다시 만들어도 복구할 수 없습니다.

이미지, 정의, 마운트 또는 데이터베이스 중 무엇이 실패했는지 판단하기

수리를 선택하기 전에 캡처한 컨테이너와 마지막으로 정상 작동한 배포를 비교하세요. 먼저 치명적인 로그의 첫 줄과 실제 적용된 정의를 확인한 다음, 문제를 다음 네 가지 분기 중 하나로 분류합니다. 새 이미지를 실행할 수 없음, 컨테이너 정의 변경, 영구 경로를 사용할 수 없음, 또는 Plex가 기존 애플리케이션 상태를 사용할 수 없음입니다.

일반적으로 Plex가 `/config`를 열기도 전에 이미지 또는 런타임 오류가 발생합니다. 아키텍처 오류, 지원되지 않는 CPU 명령어, 누락된 런타임 라이브러리, 또는 컨테이너 정의를 변경하지 않았는데 프로세스가 즉시 종료되는 경우가 이에 해당합니다. 버전에 국한된 재생 오류는 서버를 이전 Plex 이미지로 되돌린 후 사라졌습니다. 따라서 동일한 정의가 이전에 정상 작동했고 마운트나 권한이 변경되지 않았다면 롤백은 유용한 판별 방법입니다.

Plex가 미디어 누락, 빈 서버, 파일 액세스 거부, 웹 엔드포인트 없음 또는 하드웨어 액세스 손실 상태로 시작한 후 재생성 과정에서 정의 또는 마운트 오류가 나타납니다. 저장된 볼륨 소스와 적용된 볼륨 소스, UID/GID, 그룹, 포트, 네트워크 모드, 장치 및 환경 변수를 비교합니다. 모든 필드를 한꺼번에 변경하지 말고, 처음 확인된 불일치를 바로잡으세요.

데이터베이스 및 마이그레이션 메시지는 별도의 경계로 다뤄야 합니다. 새 빌드에서 스키마 변경이 시작되었다면 이전 이미지가 그 결과 상태를 읽지 못할 수 있습니다. 현재 구성을 다시 백업하고 로그를 보존하며, 여러 버전에서 반복적으로 강제 시작하지 마세요. 이 분기에는 호환되는 이미지, 업데이트 전 검증된 백업 또는 데이터베이스를 인식하는 복구가 필요합니다.

-15% OFF

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

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

마지막으로 정상 작동한 Plex 이미지로 롤백

마지막으로 성공적으로 실행된 정확한 이미지를 선택합니다. 변경될 수 있는 태그보다 보존된 이미지 다이제스트, 변경 불가능한 버전 참조 또는 로컬 이미지 ID를 우선 사용합니다. 업데이트 프로그램이 롤백된 이미지를 시작하자마자 교체하지 못하도록 자동 업데이트를 비활성화합니다.

저장된 정의에서 Plex 서비스만 다시 생성합니다. 네트워크에 영향을 주는 동일한 프로젝트 또는 컨테이너 ID를 유지하고, 동일한 `/config` 및 미디어 소스, 포트, 네트워크 모드, 환경 변수, UID/GID, 그룹 및 장치를 사용합니다. 볼륨을 제거하지 말고, 이전 이미지가 테스트되기 전에 시스템 전체 정리를 실행하지 마세요.

첫 시작 과정을 실시간으로 확인합니다. 이미지 롤백이 성공하면 원래 구성이 열리고, 동일한 서버 ID가 유지되며, 기존 라이브러리가 표시되고, 이전의 치명적인 오류가 중지되어야 합니다. 기본 로그인과 미디어 액세스가 작동할 때까지 선택적 하드웨어 트랜스코딩과 백그라운드 스캔은 미뤄 두세요.

이전 이미지에서 데이터베이스가 더 최신 버전이거나 호환되지 않거나 마이그레이션 중이라고 보고하면 중단하세요. 버전을 반복해서 전환하면 복구 지점을 파악하기가 더 어려워질 수 있습니다. 확인된 업데이트 전 구성 사본을 격리된 경로에 복원하거나, 안전하지 않은 다운그레이드를 강제로 수행하는 대신 호환되는 Plex 이미지로 진행하세요.

롤백만으로 충분하지 않을 때 원래 컨테이너 정의를 복원하세요

정상 작동이 확인된 이미지에서도 문제가 계속되면 정의 비교로 돌아가세요. 누락된 설정을 한 번에 하나씩 복원하고, 변경할 때마다 Plex만 다시 시작하세요. 이렇게 하면 증거를 명확하게 확인할 수 있습니다. 서버가 다시 작동했을 때 어떤 런타임 종속성이 원인이었는지 알 수 있습니다.

`/config` 및 미디어 마운트부터 시작하세요. 컨테이너가 의도한 경로를 인식하고 구성된 사용자로 해당 경로를 읽을 수 있는지 확인하세요. 업데이트로 인해 Plex가 다른 UID 또는 GID, 보조 그룹 또는 보안 컨텍스트로 다시 생성되었다면 마지막으로 작동한 ID를 복원하거나 스토리지 소유권을 신중하게 수정하세요. 지름길로 전체 appdata 트리를 모든 사용자가 쓸 수 있도록 설정하지 마세요.

그런 다음 웹 경로와 선택적 장치를 확인하세요. 방화벽 규칙을 변경하기 전에 이전 호스트 네트워크 또는 게시된 포트, 네트워크 별칭, 역방향 프록시 멤버십을 복원하세요. 먼저 직접 서버 경로에서 웹 인터페이스를 확인하세요. Plex가 시작되고 라이브러리를 로드하며 기본적인 소프트웨어 호환 스트림을 제공할 수 있을 때까지 GPU 장치와 렌더링 그룹 액세스는 추가하지 마세요.

정의 복구가 성공한 상태는 명확합니다. 컨테이너가 의도한 구성과 미디어를 인식하고, Plex 엔드포인트에 연결할 수 있으며, 로그에 선택한 종속성 오류가 더 이상 표시되지 않아야 합니다. 이러한 확인 후에도 동일한 데이터베이스 오류가 계속되면 컨테이너를 다시 생성하지 말고 보호된 애플리케이션 상태 브랜치로 돌아가세요.

업데이트를 다시 활성화하기 전에 Plex 데이터베이스, 라이브러리 및 재생을 확인하세요

실행 중인 프로세스는 복구 확인의 첫 단계일 뿐입니다. 직접 Plex 엔드포인트를 통해 로그인하여, 빈 구성 디렉터리를 기반으로 새로 생성된 서버가 아니라 원래 인증된 서버인지 확인하세요. 데이터베이스 손상, 반복되는 마이그레이션 시도, 예상치 못한 라이브러리 초기화가 있는지 시작 로그를 확인하세요.

기존 라이브러리 항목을 여러 개 열어 포스터, 메타데이터, 시청 상태 및 파일 경로가 있는지 확인하세요. 업데이트 전에 사용했던 동일한 스토리지에서 정상 작동이 확인된 작은 미디어 파일 하나에 액세스해 보세요. 메타데이터는 있지만 미디어에 액세스할 수 없다면 데이터베이스는 정상인 반면 미디어 마운트나 권한을 추가로 복구해야 할 수 있습니다.

먼저 로컬 클라이언트 한 대에서 알려진 파일을 재생한 다음, 해당되는 경우 문제를 드러낸 클라이언트에서도 재생하세요. 재생 모드를 기록하고 탐색이 작동하는지 확인하세요. 기본 재생이 성공하면 GPU 가속 누락, 원격 액세스 또는 자막 동작은 별도의 후속 점검 항목으로 처리하세요. 이러한 문제 때문에 복구된 서버 보존 작업이 차단되어서는 안 됩니다.

마지막으로 업데이트 프로그램을 계속 비활성화한 상태에서 Plex 서비스를 한 번 제어된 방식으로 재시작하세요. 동일한 서버 ID, 데이터베이스, 라이브러리, 메타데이터, 미디어 액세스 및 기본 재생이 재시작 후 돌아와야 복구가 성공한 것입니다. 이 전체 결과를 반복해서 확인할 수 있을 때까지 캡처한 실패 로그와 백업을 보관하세요.

중단할 시점을 파악하고 다음 Plex 업데이트를 복구 가능하게 만들기

로그에 데이터베이스 손상이 반복해서 보고되거나, 구성 파일 시스템에서 I/O 오류가 반환되거나, 유일한 상태 복사본이 부분적으로 마이그레이션되었거나, 호환되는 이미지가 해당 상태를 열 수 없는 경우에는 로컬 컨테이너 복구를 중단하세요. 이미지 식별자, 적용된 정의, 로그 및 구성 백업을 보존하세요. 이 시점에는 컨테이너를 계속 교체하는 것보다 데이터베이스를 인식하는 복원이나 스토리지 복구가 더 안전합니다.

Plex가 안정화되면 복구된 이미지 다이제스트, 컨테이너 정의, 영구 경로, 런타임 ID, 네트워크 모드, 장치 및 검증 결과를 문서화하세요. Plex가 공유 데이터베이스, 프록시 네트워크 또는 다른 스택 서비스에도 의존하는 경우에는 보다 폭넓은 단일 서비스 복구 프로세스가 유용하지만, Plex에 문제가 발생했다는 이유만으로 정상적인 종속 서비스를 복원해서는 안 됩니다.

다음 업데이트에서는 새로운 `/config` 백업을 생성하고 검증하며, 현재 이미지를 보존하고, 자동 정리를 비활성화한 뒤, Plex를 수동으로 업데이트하세요. 자동화를 다시 활성화하기 전에 서버 ID, 라이브러리, 재생 및 재시작 점검을 반복하세요. 테스트된 롤백 대상과 정상 작동하는 새 버전을 모두 보존해야 업데이트가 완료된 것으로 간주합니다.