編集したCompose設定が稼働中コンテナのcgroupに適用されていない場合、そのコンテナでは古いメモリ制限が維持されます。
YAMLを変更しても、それだけで既存のコンテナが更新されることはありません。また、通常の再起動では作成時の設定のまま同じコンテナが起動します。ハードメモリ制限を予約、スワップ許容量、親systemdスコープ、またはアプリケーションのヒープ設定と比較していることも、混乱の原因になります。Dockerが変更を無視したと判断する前に、実効cgroup値とコンテナIDを調べてください。
YAMLを鵜呑みにせず、稼働中のcgroup制限を確認する
コンテナID、作成時刻、Dockerの検査結果、cgroupのバージョン、稼働中のプロセスが使用するメモリ制御ファイルを記録します。
Linuxカーネルでは、memory.maxをcgroupのハード制限として定義し、memory.highは同じ絶対的な上限としてではなく、メモリ回収の圧力を適用します。
稼働中のcgroupに古い値が残っている場合、設定は適用されていません。新しい値が反映されているのに監視結果が異なる場合は、単位、キャッシュの計上方法、スワップ、アプリケーションレベルのメトリクスを確認してください。
再起動とコンテナの再作成を区別する
変更のデプロイに使用したコマンドの前後でコンテナIDを比較します。コマンドがrestart、up、create、NAS UIの操作、またはDockerの直接更新のどれだったかを記録してください。
Docker states that Compose restart does not apply configuration changes, because it restarts the existing service containers.
サービスを再作成する制御されたCompose更新を行うか、適切な場合はサポートされているライブリソース更新を使用します。変更したフィールドを検証できるよう、以前の検査結果を保存してください。
最終的なComposeモデルとメモリフィールドを検証する
すべてのファイル、プロファイル、環境変数の置換を適用した後、実効Compose設定をレンダリングします。制限がアクティブなサービスに設定されているか確認してください。
Compose仕様ではmem_limitをサービスのメモリ制限として定義し、同等のdeploy制限も宣言されている場合は、両者を整合させるよう求めています。
未使用のオーバーライドファイル、非アクティブなプロファイル、スペルミスのあるサービス、または別のStack UIに設定した値は、デプロイ済みのモデルを変更しません。レンダリング済みの設定とDockerの検査結果を比較してください。
ハード制限、予約、スワップを区別する
ハードメモリ制限、予約またはソフト制限、スワップ制限、現在の使用量、ピーク使用量、OOMイベントを記録します。メモリ関連の値をすべて1つの上限として扱わないでください。
systemdのリソース制御ドキュメントではMemoryHighとMemoryMaxを区別し、親cgroupがサービスやコンテナに追加の制限を課す場合があることを説明しています。
予約はハード上限と同じではないため、コンテナの使用量が予約値を超えているように見えることがあります。また、ダッシュボードによっては、スワップやページキャッシュが使用量に含まれない、または別途表示される場合があります。
ランタイムのヒープに独自の上限が設定されているか確認する
Javaアプリケーションでは、コンテナ対応のJVM検出、最大ヒープ、ダイレクトメモリ、メタスペース、スレッドスタック、およびイメージやアプリケーション設定から渡されるフラグを記録します。
Oracleのドキュメントでは、JVMは利用可能なメモリ制約に基づいてヒープサイズを設定し、MaxRAMPercentageでヒープの割合を設定できると説明されています。
コンテナの上限を変更しても、明示的な-Xmxや割合の設定が残っていると、アプリケーションのヒープが期待どおりにならない場合があります。また、ヒープメモリはプロセス全体のメモリ使用量ではありません。
Node.jsなどのアプリケーションレベルの上限を確認する
ランタイムフラグ、環境変数、ワーカー数、キャッシュ、内部メモリ目標を調べ、オペレーティングシステムの上限と比較します。
Node.jsのドキュメントでは、max-old-space-sizeはV8ヒープの上限と説明されています。コンテナに割り当てられるcgroupのメモリが増減しても、この値は変わらないことがあります。
コンテナの上限はホストを保護するもので、すべてのアプリケーションを自動的に調整するわけではありません。ネイティブメモリ割り当てとファイルシステムキャッシュのための余裕を残し、ランタイムの上限をコンテナの上限より低く設定してください。
変更は1つずつ適用し、制御された負荷で確認する
最終的なCompose設定をレンダリングし、対象サービスだけを再作成して、新しいコンテナIDと稼働中のcgroupを確認します。その後、使用量とOOMイベントを監視しながら、負荷の上限を設定してテストします。
The ZimaSpace Tech & AI Hub article explains what happens at an active container limit; this article focuses on proving that a changed limit was actually deployed.
再起動後に、レンダリングされた設定、コンテナの検査結果、cgroupファイル、ランタイムのヒープ、そして観測された障害発生の境界が、すべて意図したポリシーと一致すれば、問題は解決しています。
よくある質問
コンテナを再起動すると、変更したComposeのメモリ上限は適用されますか?
いいえ。通常、再起動しても既存のコンテナ設定がそのまま使われます。サービスを再作成するか、サポートされているライブ更新を使用してください。
コンテナは一時的にハードメモリ上限を超えることがありますか?
カーネルのアカウンティングや回収処理により、一時的に境界付近またはわずかに超える値が表示されることがあります。ただし、回収不能な使用がハードリミットに達した状態が続くと、cgroupによるOOM処理が発生します。
アプリが古いヒープサイズを報告するのはなぜですか?
アプリケーションのランタイムには、明示的なヒープフラグが設定されている場合や、起動時にのみ割合を計算する場合があります。コンテナの上限を確認したうえで、再作成または再起動してください。
サポートとヒント
続きを読む

家族に見られないように、NAS上のアダルト動画を隠す方法
家族で使うNASでは、アダルト動画を非公開に保ちましょう。フォルダーのアクセス権、PlexとJellyfinのライブラリーへのアクセス、サムネイル、視聴履歴、共有テレビのログイン情報、DLNAを確認してください。

Transformersでコミュニティモデルを読み込む前に確認すべきこと
TransformersのJinjaサンドボックスアップデートを使って、モデルの来歴、チャットテンプレート、リモートコード、シリアライズされた重み、隔離された初回実行を確認しましょう。

Mirageをローカルで実行:1枚の画像から文字認識と物体検出
Cactus Computeの小型ローカルビジョンモデルを試し、実際の入力でOCRとオブジェクト抽出を検証して、メモリ、言語、プライバシーの制限を把握しましょう。



