すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Oct 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 v 1.31 では cgroup v1 のサポートがメンテナンスモードに移行し、v 1.35 でサポートが廃止されました。cgroup v2 の主な利点は次のとおりです：

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

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

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

    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 を使用している場合は、v 1.5.1 以降にアップグレードしてください。

    cAdvisor

    cAdvisor を単体の DaemonSet としてデプロイしている場合は、v 0.43.0 以降に更新してください。

    Nginx Ingress Controller

    古いバージョンでは、cgroup v2 における CPU コア解析の誤りにより OOMKilled エラーが発生する場合があります。v 1.11.2 以降にアップグレードしてください。GitHub Issue #9665 をご参照ください。

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

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

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

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

    本番環境での推奨事項