Jellyfinのバックアップが実際に復元できるかテストする方法

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

Jellyfinのバックアップジョブが完了したことからわかるのは、ファイルまたはアーカイブが書き込まれたということだけです。それだけでは、そこから実用可能なJellyfinサーバーを再構築できるとは証明できません。

復元は隔離環境でテストしてください。既知の復旧ポイントを選び、バージョンとデプロイ時の前提条件を記録し、新しいパスに復元して、テスト用インスタンスから本番環境へ書き込めないようにしたうえで、ユーザー、視聴状況、ライブラリ、設定、再生、再起動を確認します。訓練の最後には、バックアップに含まれていなかったものをすべて書き出してください。

テストするバックアップを選ぶ前に復旧対象を定義する

障害発生後にJellyfinを実用状態に戻すために必要なものを洗い出してください。アプリケーションのデータベースと設定、ユーザー、視聴状況、ライブラリ定義、依存しているプラグイン、低コストでは再構築できないメタデータ、スタックに必要なシークレットやキー、コンテナまたはサービスの定義、UID/GID、マウント、想定するJellyfinのバージョンを含めます。

実用的なセルフホスティング復旧チェックリストでは、サービス定義、アプリケーションデータ、データベース、シークレット、インフラのメモ、復元手順を、ひとつの再構築課題として扱います。Jellyfinのメディアファイルには別の保護ポリシーを適用できますが、アプリケーションの状態は映画の入ったフォルダーで代用できません。

テスト前に復旧対象を記録しておけば、ログイン画面が表示されても、視聴履歴、プラグイン、プロキシの認証情報が欠けていることを見逃さずに済みます。バックアップにアプリのバージョンや対象パスが明記されていない場合は、開始前に復旧リスクとして記録してください。

本番環境への書き込みパスを遮断して新しい保存先に復元する

一時ディレクトリ、クローンしたデータセット、新しいDockerボリューム、予備のVM、またはテスト用ホストを使用してください。インスタンスには別のポートとホスト名を割り当て、本番環境への書き戻しにつながるリモートからの受信接続、Webhook、同期、自動化、スケジュール済みジョブを無効にしてください。

隔離された新しい場所への復元テストなら、復旧の検証を稼働中のサービスから切り離せます。バックアップが機能するか確かめるために本番環境のJellyfinディレクトリを上書きしないでください。テストが実際のインシデントになってしまいます。

ZimaSpaceの非破壊復元の境界は、ファイル、アプリ、VM、NAS全体の復旧にも同じ隔離ルールを適用します。

記録されたバージョンで起動し、初回起動を確認する

バックアップを隔離したパスに復元し、可能であれば復旧ポイントの作成時と同じバージョンのJellyfinを起動してください。テストはローカル環境で行い、インターフェースを閲覧する前に初回起動ログを確認してください。

Jellyfinでセットアップウィザードが表示されたり、新しい管理者が作成されたり、空のデータベースが初期化されたり、永続化パスに書き込めなかったり、予期しない移行がすぐに実行されたりした場合は、そこで中止してください。これらは復元の失敗またはデプロイの不整合であり、インターフェースが正常に見えるまでクリックし続ける理由にはなりません。

所有者の修正、パスの置き換え、シークレットの取得、イメージの固定、プラグインの変更など、必要だった手動作業を正確に記録してください。元の管理者が文書化されていない詳細を覚えている場合にしか機能しないリストアは、まだ信頼できる復旧プロセスとは言えません。

ファイルの展開だけでなくアプリケーションの状態も検証する

通常ユーザーと管理者をそれぞれ個別にテストします。視聴済み・未視聴の項目、再生位置、お気に入りやプレイリスト(使用している場合)、ライブラリの定義、メタデータの選択内容、スケジュール済みタスク、各メディアルートの項目を1つずつ確認してください。影響のない変更を1つ加え、Jellyfinの再起動後も保持されることを確認します。

再生については、家庭での利用にトランスコードが重要な場合、Direct Playで再生する項目を1つ、代表的なトランスコードまたは字幕の経路を1つ実行してください。データベースを復元できても、メディアのパスやハードウェアデバイスにアクセスできない場合、その訓練で確認できたのは復旧対象の一部だけです。

構造化されたリストア訓練では、合格基準と復旧時間を明確にすることが重視されます。「起動した」だけで最終合格としないよう、この考え方をJellyfinにも適用してください。

復旧時間を測定し、不足している依存関係をすべて記録する

空の復元先から、サービスが検証済みの状態になるまでの時間を計測します。データ転送時間と、手動調査、イメージのダウンロード、権限の修復、シークレットの取得、データベースの確認、メディアのマウント作業にかかる時間を分けて記録してください。これらの数値から、家庭で想定している復旧時間が現実的かどうかが分かります。

チェック項目 合格条件 失敗の兆候
バックアップへのアクセス 選択した時点のデータを復号・展開できる キー、チェーン、アーカイブ、リポジトリへのアクセスの欠落
永続状態 想定したユーザー、ライブラリ、履歴が表示される セットアップウィザード、空のデータベース、状態の欠落
パス 代表的なメディアルートにアクセスできる マウントが空、パスの変更、アクセス権の拒否
再生 通常の再生と必要なトランスコード経路が機能する コーデック、デバイス、キャッシュ、マウントの障害
再起動 正常な再起動後も状態が保持される 変更が失われる、または初期化が繰り返される
復旧時間 家庭で設定した時間内 手作業または転送が目標を超過

訓練で問題が見つかったら、すぐにバックアップジョブまたは手順書を更新してください。テスト環境が必要なチェックに合格するまでは、最新のバックアップを「動作確認済み」と見なさないでください。

よくある質問

Jellyfinのリストアテストはどのくらいの頻度で実施すべきですか?

バックアップツール、ストレージパス、暗号化キー、Jellyfinのバージョン、コンテナ構成、大規模なプラグインを変更した後に実施し、定期的なスケジュールでも繰り返してください。重要なホームサービスなら、まずは四半期ごとの訓練が妥当です。より重要な構成や変更頻度の高い構成では、さらに頻繁なテストが必要になる場合があります。

リストアテストでは、最新バージョンのJellyfinを使うべきですか?

バックアップ時に記録されたバージョンから始めて、リカバリーとアップグレードを同時に試すのではなく、リカバリーをテストしましょう。復元した状態がチェックに合格したら、それを複製またはスナップショットして、独自のロールバックポイントを設けた別の変更としてアップグレードをテストできます。

サポートとヒント

続きを読む

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.