Immichはネットワーク共有上のデータで安定して動作しますか?

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

マウント、権限、遅延、障害時の動作を適切に設計してテストすれば、Immichはメディアや外部ライブラリにネットワーク共有を安定して使用できます。ただし、PostgreSQLのデータディレクトリは、汎用のSMBまたはNFS共有ではなく、サポート対象の低遅延ストレージに置く必要があります。

「データ」という言葉では、異なるワークロードがひとまとめになってしまいます。オリジナル画像は大容量の永続ファイル、サムネイルは小さな操作を大量に発生させるもの、外部ライブラリは読み取り専用の場合があり、PostgreSQLにはデータベースに適したファイルシステムの特性が必要です。パスごとに移動先を決め、コンテナの起動前に共有をマウントし、空のローカルディレクトリがNASになりすますのを防ぎます。ホストの再起動と、管理下での共有の中断の両方で動作を確認してください。

移動前にImmichの各パスを分類する

アップロードライブラリ、サムネイルまたはエンコード済みメディア、外部ライブラリ、データベースディレクトリ、モデルキャッシュ、バックアップを個別に列挙します。各パスに誰が書き込むかと、データを失った場合の影響を記録します。メディア用の共有ストレージは適切な場合がありますが、すべてのボリュームを同じように扱う設計は、設計審査を通過できません。

実用的なNFSの手順では、共有ストレージからImmichの外部ライブラリをマウントする方法を紹介しています。その外部ライブラリのマウントパターンは、パスと権限の計画に役立ちますが、データベースにNFSを使うべきだという根拠にはなりません。

PostgreSQLはデータベース向けに推奨されるストレージに置き、ネイティブダンプとバックアップで保護します。ローカルのアクティブストレージが限られている場合は、容量を多く消費すると実測されたメディアパスのみを移動し、アプリケーションの状態全体を移動するのではなく、その境界を記録します。

リモートマウントの起動順序を確実にする

明示的な認証情報またはエクスポートルール、固定アドレス、意図した読み書きモードを指定して、ホストに共有をマウントします。Immichの起動前に、想定したファイルシステムであることと、既知のマーカーファイルがあることを確認します。マウント済みのホストパスをコンテナにバインドマウントします。

サービスマネージャーを設定し、Immichがリモートマウントを待機し、空のフォールバックディレクトリを使って起動しないようにします。起動テストは、コンテナ内でマーカーが確認でき、テストファイルの所有者が想定どおりの場合にのみ合格です。ディレクトリが空、またはファイルの所有者がrootの場合は、即時中止してください。

メンテナンス時間中に、共有が利用可能な状態と、意図的に利用できない状態の両方で、それぞれ一度再起動します。1回目のテストは、Immichの起動前にマーカーが表示された場合にのみ合格です。2回目は、Immichが停止するか、空のローカルマウントポイントへの書き込みを行わずにエラーが明示されれば合格です。

コンテナの識別と共有権限を検証する

サーバー、クライアント、コンテナ間で数値のユーザーIDとグループIDを一致させ、専用の使い捨てフォルダーで作成、名前変更、読み取り、削除をテストしてください。家族のライブラリを公開するようなグローバルな書き込み権限で不一致を解決しないでください。

使い捨てのファイルテストをホストだけでなくImmichサーバーコンテナ内からも繰り返してください。NASが意図した数値の所有者を認識することと、コンテナを再作成した後もImmichがファイルを再度開けることを確認してください。ホストでのテストに合格しても、コンテナ内のパスが正しいとは限りません。

IDや作成・名前変更の動作に違いがある場合は、対象を絞ってエクスポート、マウント、またはコンテナのマッピングを修正してください。実際のライブラリをスキャンする前に再テストしてください。広範囲な権限変更は不一致を覆い隠す一方で、家族の写真すべてを無関係なサービスにさらすおそれがあります。

レイテンシを測定し、共有の切断をテストする

代表的なアップロード、サムネイル生成、タイムラインの閲覧、オリジナルファイルのダウンロード、外部ライブラリのスキャンを実行しながら、サーバーのレイテンシとジョブの進行状況を測定してください。合格の条件は、操作時の応答が許容範囲内で、キューが継続的に増えないことです。回線速度だけではメタデータのパフォーマンスを証明できません。

あるImmichの問題報告では、NFSが不安定な環境でのデータベースとファイルの不整合が報告されています。限定的なNFS障害事例から、書き込み中の切断は復旧上のリスクとして扱うべきであり、NFSが常にImmichのデータを破損させると決めつけるべきではないことがわかります。

バックアップを完了したうえで、メンテナンス時間中に重要度の低いテストを実行しながらメディア共有を切断してください。Immichは、マウントポイント直下に書き込むのではなく、明確なエラーを示す必要があります。共有を復旧し、再起動ループを起こさずにテスト用アセットとデータベースレコードが整合することを確認してください。

再起動テスト後にGo/No-Goを判断する

コンテナとホストを別々に再起動してください。正しい共有ストレージが最初にマウントされること、既存と新規のオリジナルファイルが開けること、外部スキャンでアセットが重複しないこと、新しいアップロードがもう一度の再起動後も残っていることを確認してください。ZimaSpaceのDASとNASの比較では、レイテンシと障害ドメインのトレードオフを解説しています。

これらのテストに合格し、不在、レイテンシ、空き容量、inodeの逼迫を監視してアラートできる場合は、共有ストレージを使用してください。ネットワークやNASが必要な可用性を満たせない場合、またはマウント失敗時にローカルへ書き込む動作を防げない場合は、ローカルストレージまたは直接接続ストレージを選んでください。

Immichが空の状態で起動する、root所有のファイルを作成する、中断後にファイルが見つからないというエラーが発生する場合は、以前のローカルパスに戻してください。プロトコル、マウントオプション、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.