Composeファイルを変更したのに、実行中のコンテナのメモリ制限が古いままなのはなぜですか?

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

編集した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処理が発生します。

アプリが古いヒープサイズを報告するのはなぜですか?

アプリケーションのランタイムには、明示的なヒープフラグが設定されている場合や、起動時にのみ割合を計算する場合があります。コンテナの上限を確認したうえで、再作成または再起動してください。

サポートとヒント

続きを読む

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.