不要な書き換えを防ぎながらローカルのメタデータファイルを設定する方法

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

ローカルのNFOファイルとアートワークを使えば、メディアライブラリを持ち運べます。しかし、それらを読み取るサーバーに、タイトル、画像、IDを置き換える権限がある場合もあります。メディアを読み取り専用でマウントすれば誤操作による書き込みを防げますが、ダウンロードしたサイドカーファイルをサーバーが保存できる場所は変わります。

権限を変更する前に、メタデータの各フィールドについて、どのソースを正とするかを1つ選んでください。厳選したサイドカーファイルはバージョン管理するかバックアップし、サーバーのデータベース状態は書き込み可能な状態に保ちます。また、更新テストで、サーバーがソースファイルを書き換えずに読み取ることを確認してください。アップグレード後やライブラリ全体のメタデータ更新後にも、このテストを繰り返してください。

どのメタデータソースを正とするか決める

ローカルで管理するフィールドを一覧にしてください。タイトル、ソート用タイトル、エディション、日付、人物、プロバイダーID、ポスター、背景アートなどです。ローカルファイルを正とする場合は、更新時にこれらのフィールドが上書きされないよう、プロバイダーによる更新を無効にするか制限してください。

ファイルの命名規則を採用する前に、インストールされているサーバーファミリーのJellyfinのNFOフィールドの動作を確認してください。サポート状況はライブラリの種類によって異なり、一見明白に思えるファイル名でも、スキャナーが読み取るファイルとは限りません。

本番ライブラリの外部に、小規模なサンプルディレクトリを用意してください。映画またはエピソードを1つ、そのNFOファイル、選択したアートワークを格納すれば、厳選した何千ものファイルを危険にさらさずにスキャンと更新の動作をテストできます。

読み取り専用のメディアと書き込み可能なサーバー状態を分離する

メディアツリーはコンテナ内で読み取り専用としてマウントし、設定、キャッシュ、データベースの各パスは書き込み可能な状態にしてください。読み取り専用のバインドマウントなど、コンテナのフラグを使う方法は、リリースごとに意味が変わる可能性のあるアプリケーションのチェックボックスに頼るより確実です。

サーバーがメディアの隣に新しいアートワークをダウンロードする必要がある場合、ライブラリ全体を読み取り専用にすると、そのワークフローと両立しません。ダウンロードしたメタデータはアプリケーションの状態保存領域に保存するか、サーバープロセスの外部でサイドカーファイルを書き込む、管理されたステージングジョブを使用してください。

マウントマップをデプロイ記録の一部として扱ってください。Jellyfinコンテナのアップグレードチェックリストは、コンテナを再作成する際にメディア、メタデータ、アプリケーションの状態を区別して保つのに役立ちます。

キュレーションと競合する書き戻し経路を無効にする

フォルダーを外部でキュレーションしている場合は、アートワークやNFOメタデータをメディアフォルダーに保存するオプションをオフにしてください。また、ライブラリごとのメタデータ保存設定も確認してください。書き込みを有効にする設定は、グローバル設定以外にもある場合があります。

必要なすべての書き込み可能なパスを明示的に指定しない限り、適切なマウント設定の代わりにコンテナのファイルシステム全体を読み取り専用にしないでください。データベース、ログ、プラグイン、一時ファイルには、引き続き管理された書き込み可能な場所が必要です。

サンプルのNFOファイルと画像のハッシュまたは更新日時を記録し、ライブラリをスキャンして、UIでタイトルを編集した後、メタデータをリフレッシュしてください。アプリケーションが許可されたローカル状態をデータベースに記録する一方で、ファイルは変更されないはずです。

復元とアップグレード時の動作を確認する

キュレーションしたサイドカーファイルは、メディアサーバーのデータベースとは別にエクスポートまたはバックアップしてください。サイドカーファイルは表示用のメタデータを復元しますが、データベースには、視聴状況、ユーザー、コレクションなど、ローカルファイルではカバーされない情報が含まれている場合があります。

テスト期間中にコンテナを再作成し、読み取り専用マウントのフラグがデプロイの過程でも維持されることを確認してください。その後、サンプルディレクトリをスキャンしてハッシュを再度比較します。アップグレードによって新しいメタデータ保存機能が追加されたり、デフォルトが変更されたりすることがあるためです。

最終的な停止ルールはシンプルです。意図した結果を保つためにリフレッシュ時の書き込みアクセスが必要なら、信頼できる情報源の設計は未解決です。サンプルを復元し、本番環境を読み取り専用に保ち、そのフィールドをサーバーと外部キュレーターのどちらが管理するか決めてください。

サポートとヒント

続きを読む

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.