Immichのメモリ制限はどのくらいに設定すべき?

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

汎用的なGB数を基準に、Immichのメモリ上限を一律に設定しないでください。ホスト全体のRAM目標とコンテナごとの上限は、異なる問題を解決します。ホストにはスタック全体を稼働させる容量が必要です。一方、コンテナの上限は、正当なImmichのワークロードを停止させずにホストを保護するためのものです。

処理済みのライブラリを閲覧するだけなら軽く見えても、機械学習のコールドスタート、大規模なインポート、サムネイル生成、顔分析、動画処理では、はるかに多くのメモリを消費することがあります。実際に必要となる最も負荷の高いワークロードを測定し、PostgreSQLとオペレーティングシステムのための余裕を確保してください。OOMキルが繰り返し発生するなら、通常のスロットリングではなく、上限設定が不適切だと判断してください。

上限を決める前にメモリプレッシャーを測定する

次の3つの状態でメモリを記録してください。閲覧のみの待機状態、代表的な日常のアップロード、そして予定しているバックグラウンド処理のうち最も負荷の高いものです。コンテナの使用量、ホストの空きメモリ、スワップの動作、OOMイベント、ジョブが進行し続けているかを記録します。Linuxのメモリ計上には回収のされ方が異なる複数の種類のメモリが含まれるため、docker statsでの単一のピーク値だけでは不十分です。

有用なDockerのcgroupメモリ内訳では、合計値をすべて同じように危険とみなすのではなく、匿名メモリ、ファイルバックキャッシュ、スラブを分けて考えます。ホストに十分な余裕がある状態でファイルキャッシュが安定している場合と、匿名メモリが増え続ける場合、スワップの圧迫、または同じImmichのジョブ中に増加するcgroupのOOMカウンターは別物です。

再現性のある使用量の上限を特定し、その大半が回収可能なキャッシュなのか、実際に使用中のメモリなのかを説明できる段階まで進めましょう。ワークロードが変わっていないのに使用量が増え続ける、コンテナが繰り返しOOMキルされる、またはホストで大量のスワップが発生する場合は、その実行結果をもとに容量を決めるのをやめ、まず異常な増加の原因を調べてください。

Immichで想定される最も重いワークロードに合わせて上限を設定する

上限を適用した後も対応できなければならないワークロードを選んでください。ある家庭では、Smart Searchと顔認識の処理が追いつくまでの間に、4台のスマートフォンからアップロードがある状況かもしれません。別の家庭では、大規模な初回インポートの後に通常の閲覧が行われる状況かもしれません。上限が明確に定めたサービス要件に合致するよう、測定中はデータセット、モデル、並列処理の設定、他のコンテナを固定してください。

短時間の急増に備えて測定可能な余裕を持たせつつ、PostgreSQL、ファイルシステムキャッシュ、コンテナランタイム、その他のサービスにホストメモリを確保できるよう、観測された回収不能メモリのピークより上にハード上限を設定してください。ZimaSpaceの「ローカルAIのリソース不足を示す警告サイン」チェックリストが役立ちます。発熱、スワップの発生、突然の再起動は、Immichだけのグラフでは見逃す可能性があるホストレベルの負荷を示すためです。「コンテナが一度上限に達した」ことを、RAMを増やす必要がある証拠と捉えないでください。重要なのは、同じ適切なワークロードで処理が著しく遅くなる、ジョブが失われる、スワップが継続する、またはOOMキルが発生するかどうかです。逆に、Immichのcgroupが限界に達する前にImmichがデータベースやホストのリソースを圧迫するなら、上限が緩すぎます。

異常な増加には、上限を引き上げる前に負荷を減らす

提案した上限を超えるのが特定のバックグラウンド処理のときだけなら、上限を引き上げる前に、そのジョブの並列数を減らすか、処理段階を分離してください。機械学習、サムネイル生成、動画処理、データベース処理では、メモリの使用傾向が異なる場合があります。処理中のバッチを小さくすると完了まで時間がかかることがありますが、家庭内で使うインターフェースの応答性を保ち、ホストを復旧可能な状態に維持できます。

バージョン固有の不具合も重要です。Immich v3.0.3のメモリに関する報告では、ロケール関連の不正な状態の後、機械学習ワーカーのメモリ使用量が増え続け、cgroupの上限に達してOOMが発生したと説明されています。この事例は、Immichの通常のRAM使用量を示すものではありません。原因不明の増加をホストのメモリ予算の恒久的な引き上げとして処理する前に、ソフトウェアまたは設定に起因する問題として検討すべき理由を示しています。

同時実行数、モデル、バージョンのいずれか1つを変更した後、同じワークロードを再実行します。メモリ使用状況と元のジョブの両方が、期待どおりの方向に改善した場合にのみ、その変更を維持してください。メモリが安定したプラトーに近づかずに増え続ける場合は、ログとバージョンの詳細を保存して、ハードリミットを際限なく引き上げるのではなく、問題をエスカレーションしてください。

コールドリスタート後と高負荷サイクルで上限を検証する

キャッシュとモデルの常駐状態を既知のコールド状態から始められるよう、ホストを再起動します。通常のログインとブラウジングの確認を行ってから、代表的なアップロードとバックグラウンドのワークロードを実行します。匿名メモリのピーク、キャッシュ、スワップ、OOMカウンター、データベースの応答、キューの処理完了までの時間、および他の重要なコンテナが応答し続けるかどうかを記録してください。

許容できる上限は、コールドスタートと最も負荷の高い通常サイクルの両方を、OOMによるプロセス強制終了、持続的なスワップの過剰使用、コンテナの繰り返し再起動、または処理が進まなくなるキューなしで乗り切れる必要があります。また、Immichの負荷が高いときでも、データベースのダンプや管理者ログインなどの復旧作業を行えるだけのホスト側の余力を残してください。

定義した家庭内のワークロードがすべて正常に完了し、人工的な負荷テストだけが失敗する場合は、必要のないシナリオのためにRAMを購入するのではなく、許容できる範囲としてその境界を記録してください。

実際のワークロードを実行するとホストのリソースを使い果たしてしまう場合は、同時実行数を減らす、機械学習を分離する、メモリを増設する、または競合するサービスを移動してから、同じ検証を再実施し、新しい上限が安全だと判断してください。

サポートとヒント

続きを読む

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.