コンテナのアップデート失敗後にPlexを復元する方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

別のイメージをプルする前に、障害が発生したPlexコンテナと自動アップデーターを停止してください。まず現在のログと実際のPlex設定パスを保存します。問題のあるコンテナが自動で置き換わったり、アプリケーションの状態に書き込んだりできないようにしておくと、復旧がはるかに安全になります。

家庭用NASでは、コンテナのアップデートは複数の異なる層で失敗することがあります。新しいイメージが起動しない場合もあれば、再作成されたサービスでボリュームやネットワーク設定が失われる場合や、新しいPlexビルドが既存のアプリケーションデータを異なる方法で開く場合もあります。特に重要なのは、永続化されたPlexの設定、なかでも`/config`配下のデータベースとメタデータです。この手順では、変更を加える前にイメージ、コンテナ定義、マウント、データベースを切り分け、障害が起きた最小限の層だけを復元して、元のサーバーの識別情報、ライブラリ、再生を確認します。ログにデータベースの破損や取り消せない移行が示されている場合は、その状態の唯一のコピーに古いイメージを無理に適用する前に停止してください。

アップデートのループを停止し、障害発生時の状態を保存する

Plexの自動アップデーターを無効にし、頻繁な再起動ループを停止してください。Plexが連携した停止を必要とするデータベースを共有していない限り、ほかの正常なサービスは稼働させたままにします。目的は、アプリスタック全体を再起動して経緯を消すことではなく、障害をそのまま保って調査できるようにすることです。

失敗したコンテナの正確なイメージタグ、イメージID、入手できる場合はダイジェストを記録してください。実際に適用されたマウント、環境変数、公開ポート、ネットワークモード、ネットワークエイリアス、デバイスの割り当て、追加グループ、再起動ポリシー、ヘルス状態も保存してください。`latest`のようなタグは、時期によって異なるイメージ内容を指すことがあるため、それだけでは信頼できるロールバック記録になりません。

次の起動を試す前に直近のログをエクスポートし、最終終了コードだけでなく、最初に発生した致命的なメッセージを記録してください。ファイルの欠落、アクセス拒否、データベースエラー、未対応命令、アドレスの競合では、それぞれ復旧方法が異なります。また、アップデートの実行時刻とコンテナが再作成されたかどうかも記録してください。イメージをプルしただけでは既存のコンテナは変わりませんが、再作成すると実際の定義が変わる場合があります。

障害を再現でき、どのイメージが実行されたか、どの永続パスが使われたか、どの実行時設定が適用されたか、最初にどのエラーが発生したかの4点に答えられれば、作業を続けられます。それらがまだ分からない場合、再度のプルや再起動はノイズを増やすだけで、復旧の安全性は高まりません。

コンテナ再作成の前に Plex の設定を保護する

コンテナは交換可能であり、Plex の設定は永続化されるものとして扱ってください。重要な状態は通常、`/config` にマウントされたホストパスまたは名前付きボリュームに保存されます。メディアライブラリは別のマウントにしてください。同じ永続データを再接続し、空のディレクトリを参照しない場合に限り、サービスの再作成は低リスクです。

ホストから、またプラットフォームが対応していれば一時的な読み取り専用環境からも、マウントを調べてください。想定されるデータベース、設定、メタデータ、プラグインデータ、ログが存在することを確認します。マウント元、ファイルシステム、所有者、権限、空き容量、読み取り専用に切り替わっていないかを記録してください。想定パスに空のディレクトリがある場合は、作業を止めるべき警告です。Plex にそこで新しいサーバーを作らせてよいという意味ではありません。

ロールバックを試す前に、対象となる設定パス全体をバックアップし、バックアップの内容を一覧表示できること、または隔離した場所に復元できることを確認してください。ファイルシステムがスナップショットに対応していれば、復旧を迅速化できます。ただし、同じストレージデバイスが故障している可能性がある場合、スナップショットだけを唯一のコピーにしないでください。サーバーの正常動作を確認するまで、障害が発生した状態と最後に正常だったバックアップの両方を保持してください。

古いイメージを起動させるために、設定ファイル、データベースファイル、メタデータを削除しないでください。設定を一貫した状態で読み取れない、所有権が不明、またはコピーを検証できない場合は、ストレージまたはデータベースの復旧に直接進んでください。コンテナを再作成しても、信頼できない状態の保存元は修復できません。

イメージ、定義、マウント、データベースのどれに障害があるかを判断する

修復方法を選ぶ前に、取得したコンテナ情報を最後に動作していたデプロイと比較してください。まず最初の致命的なログ行と実際に適用されている定義を確認し、そのうえで障害を次の4つに分類します。新しいイメージを実行できない、コンテナ定義が変わった、永続パスを利用できない、または Plex が既存のアプリケーション状態を利用できない。

Plex が `/config` を開く前に、通常はアーキテクチャエラー、未対応の CPU 命令、ランタイムライブラリの不足、またはコンテナ定義を変更していないのにプロセスが即座に終了するなど、イメージまたはランタイムの障害が発生します。バージョン固有の再生障害がサーバーを以前の Plex イメージに戻すと解消した例があるため、同じ定義で以前は動作し、マウントや権限にも変更がない場合、ロールバックは有用な切り分け方法になります。

再作成後、メディアが見つからない、サーバーが空になる、ファイルアクセスが拒否される、Webエンドポイントが利用できない、またはハードウェアへのアクセスが失われる場合は、定義またはマウントに問題があります。保存済みの設定と実際に適用されているボリュームソース、UID/GID、グループ、ポート、ネットワークモード、デバイス、環境変数を比較します。すべての項目を一度に変更するのではなく、最初に確認できた不一致を修正してください。

データベースと移行に関するメッセージは、別の判断が必要です。新しいビルドでスキーマ変更が始まっていた場合、古いイメージでは変更後の状態を読み取れない可能性があります。現在の設定をもう一度バックアップし、ログを保管して、複数のバージョンをまたいで何度も起動を強制しないでください。この場合は、互換性のあるイメージ、更新前の検証済みバックアップ、またはデータベースを考慮した修復が必要です。

確認された結果 主な分岐 最初の修復
`/config`を読み取る前にプロセスが終了する イメージまたはランタイム 変更していない定義で、保持してある正常動作確認済みのイメージを起動する
Plexが新規または空のサーバーとして起動する 誤った`/config`のマッピング 停止して、元のマウント元を復元する
設定またはメディアで権限エラーが表示される マウントの所有権または読み取り専用状態 実績のあるUID/GID、グループ、またはストレージアクセスを復元する
ログに移行またはデータベースの障害が表示される アプリケーションの状態 状態を保持し、互換性のあるイメージまたは検証済みバックアップを使用する

最後に正常動作したPlexイメージにロールバックする

最後に正常動作した正確なイメージを選びます。変動するタグより、保持されたイメージダイジェスト、不変のバージョン参照、またはローカルイメージIDを優先します。アップデーターが起動直後にロールバック用イメージを置き換えないよう、自動更新は無効にしておきます。

保存済みの定義からPlexサービスのみを再作成します。ネットワークに影響する場合は、同じプロジェクトまたはコンテナIDを維持し、同じ`/config`とメディアソース、同じポート、ネットワークモード、環境変数、UID/GID、グループ、デバイスを使用します。ボリュームは削除せず、以前のイメージをテストする前にシステム全体のクリーンアップを実行しないでください。

初回起動をリアルタイムで確認します。イメージのロールバックに成功すると、元の設定が開き、同じサーバーIDが維持され、既存のライブラリが表示され、以前の致命的なエラーが発生しなくなるはずです。基本的なログインとメディアへのアクセスが機能するまでは、オプションのハードウェアトランスコーディングとバックグラウンドスキャンは後回しにします。

古いイメージが、データベースがより新しい、互換性がない、または移行の途中であると報告したら、作業を中止してください。バージョンを何度も切り替えると、復旧ポイントの把握が難しくなります。安全でないダウングレードを無理に行うのではなく、アップデート前に確認済みの設定コピーを隔離したパスに復元するか、互換性のあるPlexイメージにアップグレードしてください。

ロールバックだけでは不十分な場合に、元のコンテナ定義を復元する

正常動作が確認済みのイメージでも失敗する場合は、定義の比較に戻ってください。不足している設定を一度に1つだけ復元し、変更するたびにPlexだけを再起動します。これにより、原因の特定に必要な情報を明確に保てます。サーバーが復旧すれば、どのランタイム依存関係が原因だったのかがわかります。

まず、`/config`とメディアのマウントを確認します。コンテナが意図したパスを認識し、設定されたユーザーとして読み取りできることを確認してください。アップデートによってPlexが別のUIDまたはGID、追加グループ、あるいは異なるセキュリティコンテキストで再作成された場合は、最後に正常動作していたIDを復元するか、ストレージの所有権を適切に修正してください。安易な回避策として、appdataツリー全体を書き込み可能にしないでください。

次に、Web経由の接続とオプションのデバイスを確認します。ファイアウォールのルールを変更する前に、以前のホストネットワークまたは公開ポート、ネットワークエイリアス、リバースプロキシのメンバー設定を復元してください。まず、サーバーへの直接接続でWebインターフェースを確認します。Plexが起動してライブラリを読み込み、基本的なソフトウェア互換ストリームを配信できるようになってから、GPUデバイスとレンダーグループへのアクセスを追加してください。

定義の修復が成功した状態は明確です。コンテナが意図した設定とメディアを認識し、Plexのエンドポイントに接続でき、ログに該当する依存関係エラーが表示されなくなっている状態です。これらを確認しても同じデータベースエラーが残る場合は、コンテナの再作成をやめ、保護されたアプリケーション状態の復旧手順に戻ってください。

アップデートを再度有効にする前に、Plexのデータベース、ライブラリ、再生を確認する

実行中のプロセスがあることは、復旧時の最初の確認事項にすぎません。Plexの直接エンドポイントからサインインし、空の設定ディレクトリを使って新たに作成されたサーバーではなく、元の認証済みサーバーであることを確認してください。起動ログを確認し、データベースの破損、移行の繰り返し、予期しないライブラリの初期化がないか調べてください。

既存のライブラリ項目をいくつか開き、ポスター、メタデータ、視聴状況、ファイルパスがあることを確認してください。更新前と同じストレージにある、小さくて正常と分かっているメディアファイルへのアクセスもテストしてください。メタデータが存在するのにメディアを利用できない場合、データベースは正常でも、メディアのマウントや権限の修復が必要な可能性があります。

既知のファイルを、まず1台のローカルクライアントで再生し、該当する場合は障害が発生したクライアントでも再生してください。再生モードを記録し、シークできることを確認してください。基本的な再生に成功した場合は、GPUアクセラレーション、リモートアクセス、字幕の動作に関する問題を個別の追加対応として扱ってください。復旧したサーバーを保全するうえで、これらの問題が妨げになることはありません。

最後に、アップデーターを無効にしたまま、Plexサービスを制御された方法で1回再起動してください。同じサーバーID、データベース、ライブラリ、メタデータ、メディアへのアクセス、基本的な再生が再起動後に復旧した場合にのみ、復旧成功と判断できます。この結果を再現できるまで、取得した障害時のログとバックアップを保管してください。

中止すべきタイミングを見極め、次回のPlex更新を復旧可能にする

ログでデータベースの破損が繰り返し報告される、設定ファイルシステムがI/Oエラーを返す、唯一の状態コピーが一部だけ移行されている、または互換性のあるイメージで開けない場合は、ローカルでのコンテナ修復を中止してください。イメージ識別子、有効な定義、ログ、設定のバックアップを保持してください。この段階では、コンテナをさらに入れ替えるより、データベースを考慮した復元やストレージの修復のほうが安全です。

Plexが安定したら、復旧したイメージのダイジェスト、コンテナ定義、永続化パス、実行時のID、ネットワークモード、デバイス、検証結果を記録してください。Plexが共有データベース、プロキシネットワーク、その他のスタックサービスにも依存している場合は、より広範な単一サービスの復旧プロセスが役立ちます。ただし、Plexの障害だけを理由に、正常な依存サービスまで復元する必要はありません。

次回の更新では、新しい`/config`バックアップを作成して検証し、現在のイメージを保持し、自動削除を無効にして、Plexを手動で更新してください。自動更新を再び有効にする前に、ID、ライブラリ、再生、再起動の確認を繰り返してください。テスト済みのロールバック先と動作する新バージョンの両方を確保できて初めて、更新は完了です。

サポートとヒント

続きを読む

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.