すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:ノードの cgroup v2 への移行

    ドキュメントセンター

    Container Service for Kubernetes:ノードの cgroup v2 への移行

    最終更新日:Jun 16, 2026

    cgroup v2 はリソース制御を統合し、メモリ処理を改善し、Kubernetes との互換性を確保します。

    Cgroup バージョン

    Linux カーネルは、プロセスグループの物理リソース (CPU、メモリ、I/O など) を制限、計測、分離するために、cgroup v1 と cgroup v2 を提供します。cgroup v2 は、統一されたコントローラー モデルにより、v1 の複数階層の問題を解決します。ファイルシステムのインターフェイスは互換性がないため、cgroupfs に直接アクセスするアプリケーションは更新する必要があります。

    「Differences between cgroup v1 and cgroup v2」をご参照ください。

    Kubernetes v1.31 では cgroup v1 のサポートがメンテナンスモードに移行し、v1.35 でサポートが終了しました。cgroup v2 の主な利点は次のとおりです：

    • 安定性の向上：統一されたメモリ計測によりページキャッシュを効果的に管理し、ディスク I/O が高いアプリケーションがメモリを占有して OOMKilled イベントを引き起こすという cgroup v1 の問題を解消します。

    • 統一された階層：すべてのリソース コントローラー (CPU、メモリなど) が単一の階層を共有するため、cgroup v1 の並列階層に起因する設定競合を排除できます。

    • リソース可観測性の強化：Pressure Stall Information (PSI) は、CPU、メモリ、I/O でストールした時間を計測し、ボトルネック分析のための粒度の細かいメトリクスを提供します。

    cgroup バージョンの確認

    ノードにログオンし、次のコマンドを実行して cgroup バージョンを確認します。

    # 対象ノードにログオンした後にこのコマンドを実行します
stat -fc %T /sys/fs/cgroup/

# 想定される出力：
# cgroup2fs --> cgroup v2 を示します
# tmpfs     --> cgroup v1 を示します

    移行手順

    ノードレベル：オペレーティングシステムの変更

    ノードの cgroup バージョンは、オペレーティングシステムによって決まります。

    アプリケーションレベル：ワークロード互換性の確保

    cgroup v1 と v2 では、ファイルシステム構造とパラメーター名に互換性がありません。/sys/fs/cgroup を直接読み取るアプリケーションは、cgroup v2 向けに検証またはアップグレードする必要があります。

    カテゴリ

    説明

    Java アプリケーション

    • DragonWell： 11.0.16.12 以降、8.15.16-GA 以降。

    • OpenJDK/HotSpot： jdk8u372 以降、11.0.16 以降、15 以降。

    • IBM Semeru Runtimes： 8.0.382.0 以降、11.0.20.0 以降、17.0.8.0 以降。

    • IBM Java： 8.0.8.6 以降。

    Go アプリケーション

    uber-go/automaxprocs を使用している場合は、v1.5.1 以降にアップグレードしてください。

    cAdvisor

    cAdvisor をスタンドアロンの DaemonSet としてデプロイしている場合は、v0.43.0 以降に更新してください。

    Nginx Ingress

    古いバージョンでは、cgroup v2 における CPU コアの解析が不正確なため、OOMKilled エラーが発生する場合があります。v1.11.2 以降にアップグレードしてください。「GitHub Issue #9665」をご参照ください。

    ACK の Nginx Ingress コントローラー をアップグレードするには、「Upgrade the Nginx Ingress Controller component」をご参照ください。
    その他のアプリケーションとコンポーネント

    • サードパーティ製の監視および APM エージェント：Prometheus Node Exporter、Datadog Agent、SkyWalking などのツールは、メトリクス取得のために cgroupfs を読み取ります。互換性のないバージョンでは、データ欠損や異常が発生する可能性があります。cgroup v2 をサポートするバージョンにアップグレードしてください。

    • セキュリティおよび監査ツール：Falco や Sysdig などのツールは、イベントの帰属に cgroup データを使用します。互換性のないバージョンでは、検知ルールの失敗や誤検知が発生する可能性があります。互換性のあるバージョンにアップグレードし、テスト環境でルールを検証してください。

    • パフォーマンスに敏感なアプリケーションおよびカスタムスクリプト：起動スクリプトで cgroup ファイルを読み取り、オートチューニング (CPU クォータに基づいてスレッド数を設定するなど) を行っている場合、cgroup v2 ではパスが変更されるため動作しません。これらのスクリプトを見直し、cgroup v2 向けに更新してください。

    本番環境での推奨事項