Plex 컨테이너를 업그레이드하기 전에 영구 상태를 보호하고, 정상 작동이 확인된 이미지를 기록하며, 종속성을 검증하고, 새로운 항목을 가져오기 전에 롤백이 가능하도록 준비하세요.
업그레이드는 단순히 이미지를 새로 고치는 습관이 아니라 통제된 변경이어야 합니다. 컨테이너 자체는 교체할 수 있지만 Plex 데이터베이스, 메타데이터, 마운트, GPU 액세스, 네트워크 모드 및 주변 서비스는 그렇지 않을 수 있습니다. 이전에 정상 작동하던 상태를 복원할 수 있을 만큼 충분한 정보를 수집한 다음, 매번 동일한 소규모 테스트 세트로 새 버전을 검증하세요.
이미지를 교체하기 전에 영구 상태 보호하기
새 컨테이너가 백업되지 않은 상태를 손상시키거나 마이그레이션한다면 가장 빠른 롤백도 소용이 없습니다. 백업에는 Compose YAML 사본뿐 아니라 영구적인 Plex 데이터 경로와 복원 절차가 포함되어야 합니다.
컨테이너 업그레이드 계획에서는 영구 상태를 보호하고, 롤백을 정의하며, 결과를 검증해야 합니다.
백업 방식에 Plex 중지 또는 일시 정지가 필요한 경우 그렇게 한 뒤 영구 상태를 캡처하고, 백업을 읽을 수 있는지 확인하세요. 테스트 환경에서 백업을 복원할 수 없다면 업그레이드를 연기하세요.
정확히 작동하는 이미지와 구성 기록하기
변동 가능한 latest 태그만 사용하면 문제가 발생한 뒤 마지막으로 정상 작동한 상태를 재현하기가 더 어려워집니다. 이미지 참조, 환경 변수, 마운트, 장치 및 네트워크 설정을 함께 캡처해야 합니다.
Docker Compose 서비스 정의를 사용하면 볼륨, 영구 경로 및 서비스 경계를 명확하게 지정할 수 있습니다.
현재 이미지 다이제스트 또는 명시적인 버전과 함께 배포 파일 및 Plex에 필요한 환경 값을 저장하세요. 추측 없이 이전 컨테이너를 재현할 수 없다면 롤백 준비가 된 것이 아닙니다. 영구 컨테이너 데이터와 마운트 계약을 독립적으로 보호할 때만 이미지를 교체 가능한 상태로 유지할 수 있습니다.
호스트 및 연동 서비스 종속성 확인하기
Plex 이미지 업데이트로 인해 이전 버전에서는 명확히 드러나지 않았던 드라이버, GPU 장치, 파일 시스템, 프록시 또는 연동 서비스 종속성이 드러날 수 있습니다. 변경 전에 이러한 인터페이스를 빠르게 사전 점검해야 합니다.
다중 서비스 미디어 스택에서는 Plex가 미디어 경로, 스토리지 및 작업 처리 시점을 공유하는 다른 서비스와 함께 배치될 수 있습니다.
업그레이드 전과 직후에 마운트, UID/GID, 하드웨어 장치 액세스, DNS 및 프록시 연결 가능성을 확인하세요. Plex와 동시에 종속성 하나가 변경되는 경우 변경 사항을 분리하여 장애의 원인을 계속 확인할 수 있도록 하세요.
고정된 업그레이드 후 테스트 세트로 검증하기
컨테이너가 실행 중이라는 사실만으로는 업그레이드 성공을 입증할 수 없습니다. 로그인, 라이브러리 탐색, Direct Play, 예상되는 트랜스코딩 한 건, 메타데이터 쓰기, 원격 액세스 및 백그라운드 작업을 모두 확인해야 합니다.
사용률, 포화도 및 오류 점검을 통해 리소스가 단순히 사용 중인 것인지, 실제로 제한되었거나 장애가 발생한 것인지 구분할 수 있습니다.
각 업그레이드 후 동일한 짧은 스모크 테스트를 실행하고 이전 버전과 리소스 사용량을 비교하세요. 중요한 테스트가 실패하거나 리소스 요구량이 크게 달라지면 먼저 롤백한 뒤 릴리스를 조사하세요.
지원 및 팁
더 읽어보기

라이브 TV 녹화 저장 공간, 보존 기간 및 정리 가이드
실제 녹화 데이터를 측정하고, 헤드룸을 확보하며, 보관 기간과 용량 제한을 함께 적용하고, 저장 공간이 가득 차기 전에 가장 오래된 조건 충족 프로그램이 삭제되는지 확인하세요.

데이터베이스 복원 후 홈 미디어 메타데이터 복구 워크플로우
복원된 상태를 보호하고 미디어 식별 정보와 경로를 확인한 다음, 메타데이터를 광범위하게 변경하기 전에 파일럿 라이브러리에서 누락된 아트워크나 일치 항목을 복구하세요.

오디오, 비디오 및 자막용 Jellyfin 클라이언트 호환성 체크리스트
대표 파일을 한 번에 하나의 변수만 테스트하고, 모든 클라이언트에 대해 Direct Play, 리먹스, 오디오 변환, 비디오 트랜스코딩 또는 실패를 기록하세요.

