cgroupv2移行が現実になった背景と2026年時点の状況
cgroup(Control Groups)はLinuxカーネルがプロセスのCPU・メモリ・I/Oを管理するための仕組みです。バージョン2(cgroupv2)は2016年にカーネル4.5でマージされ、長らく「実験的」とみなされていましたが、現在はディストリビューションのデフォルトとして広く採用されています。
2026年時点の主要ディストリビューションの状況は次のとおりです。Ubuntu 22.04 LTS以降はインストール直後からcgroupv2のみを使用する「unified hierarchy」がデフォルトです。RHEL 9系(およびAlmaLinux 9・Rocky Linux 9)も同様で、cgroupv1は無効化されています。Debian 12(Bookworm)もcgroupv2がデフォルトです。
一方、RHEL 8系やUbuntu 20.04 LTSはまだ「hybrid mode」または純粋なcgroupv1で動作しているケースがあります。長期稼働のKubernetesクラスターや古めのDockerホストがこれに該当することが多く、OSアップグレードや新規ノード追加のタイミングでcgroupv1とcgroupv2が混在する状況が生まれます。この混在状態を計画的に解消するのが、本記事で扱う移行シナリオです。
cgroupv2への移行を後押しする実際の理由として、メモリ管理の改善(PSI: Pressure Stall Informationによる正確なリソースプレッシャー計測)、rootlessコンテナのリソース制限が正しく機能する点、そしてKubernetes 1.25以降でcgroupv2がGA(一般提供)となりデフォルト推奨になったことが挙げられます。
移行前に確認すべきコンテナランタイム互換性
本番ホストをcgroupv2に切り替える前に、稼働中のコンテナランタイムとそのバージョンを確認します。対応状況の目安は以下のとおりです。
- containerd 1.4以降:cgroupv2に対応。1.4未満が残っている場合はアップグレードが必須です。
- Docker Engine 20.10以降:cgroupv2対応済み。それ以前のバージョンは一部のリソース制限オプションが無視されることがあります。
- cri-o 1.20以降:対応済み。
- runc 1.0.0-rc93以降:cgroupv2のネイティブサポートが入っています。
ランタイムのバージョン確認は containerd --version、docker version、crio --version などで行えます。またホストのcgroupマウント状態は次のコマンドで確認できます。
stat -fc %T /sys/fs/cgroup/
出力が cgroup2fs であればcgroupv2、tmpfs であればv1(またはhybrid)です。
次に確認すべきはKubernetesのバージョンとcgroupDriverの設定です。kubeletの設定ファイル(多くの場合 /var/lib/kubelet/config.yaml)に cgroupDriver: systemd が記載されているかを確認します。cgroupv2環境ではdriverを cgroupfs ではなく systemd に設定しなければなりません。Kubernetes 1.22以降は systemd がデフォルトになっていますが、旧バージョンからアップグレードしたクラスターでは明示的な変更が必要です。
よくあるつまずきとして、kubeletのcgroupDriverとコンテナランタイムのcgroupDriverが食い違うケースがあります。この状態では起動直後にPodがCrashLoopBackOffになります。移行前に両者の設定を必ず照合してください。
カーネルブートパラメータによる段階的移行手順
cgroupv2への切り替えはカーネルブートパラメータで制御します。GRUBを使うシステムでは /etc/default/grub の GRUB_CMDLINE_LINUX を編集します。
cgroupv1を無効化してv2のみにする場合は systemd.unified_cgroup_hierarchy=1 を追加します。逆にhybridモードを使いたい場合は systemd.unified_cgroup_hierarchy=0 と GRUB_CMDLINE_LINUX_DEFAULT に cgroup_no_v1=net_cls,net_prio などを加える方法もありますが、現行ではunifiedに直接移行するほうがシンプルです。
GRUB_CMDLINE_LINUX="systemd.unified_cgroup_hierarchy=1"
編集後、GRUBの設定を更新します。
# Debian/Ubuntu系
sudo update-grub
# RHEL/AlmaLinux/Rocky系
sudo grub2-mkconfig -o /boot/grub2/grub.cfg
更新後は再起動が必要です。本番ノードで実施する場合は、まずKubernetesのノードをcordon+drainして稼働中のPodを退避させてから再起動するのが原則です。
kubectl cordon <ノード名>
kubectl drain <ノード名> --ignore-daemonsets --delete-emptydir-data
再起動後、 stat -fc %T /sys/fs/cgroup/ で cgroup2fs が返ることを確認します。続いてkubeletとコンテナランタイムのcgroupDriverが systemd に統一されていることを確認し、ノードをuncordonして戻します。
複数ノードを持つクラスターでは、1台ずつこの手順を繰り返す「ローリング移行」を推奨します。全台を同時に再起動すると一時的にクラスター全体のキャパシティが落ちるため、業務への影響が大きくなります。
移行後の検証:cgroup階層と実行コンテナの動作確認
再起動後の検証は「カーネルレベル」「ランタイムレベル」「アプリケーションレベル」の3段階で行います。
カーネルレベル:前述の stat -fc %T /sys/fs/cgroup/ に加え、/sys/fs/cgroup/ 配下を確認します。cgroupv2では memory.current、cpu.stat などの統一ファイルが存在します。cgroupv1の /sys/fs/cgroup/memory/ のような個別サブシステムディレクトリが存在しなければ移行成功です。
ランタイムレベル:systemdが認識しているcgroupバージョンを確認します。
systemctl --version | grep -i cgroup
# または
systemd-cgls | head -20
containerdの場合は crictl info | grep -i cgroup でドライバーが systemd と表示されることを確認します。
アプリケーションレベル:実際にテスト用のPodをデプロイし、メモリ・CPUの制限が機能しているかを確認します。想定例として、resources.limits.memory: 128Mi を指定したPodを起動し、kubectl top pod や cat /sys/fs/cgroup/$(cat /proc/self/cgroup | head -1 | cut -d: -f3)/memory.current で実際の消費量が取得できるかを見るやり方があります。
またPSI(Pressure Stall Information)が利用可能になったかを確認するには cat /proc/pressure/memory が値を返すことを見ます。PSIはcgroupv2環境でのみ動作し、OOMキラーが発動する前にリソース逼迫を検知する用途に使えます。
切り戻し判定フローと手順
移行後に問題が発生した場合、切り戻しの判断基準を事前に決めておくことが重要です。以下に一般的な判定フローを示します。
即時切り戻しが必要な状態
- kubeletが起動しない、またはNotReady状態が解消しない
- コンテナのCPU・メモリ制限がまったく効かず、ホストがリソース枯渇に陥る
- 既存のPodが大量にCrashLoopBackOffになり、ドレイン先のノードが受け入れ不能になる
様子を見てよい状態(段階的対処)
- 一部のDaemonSetがRestartを繰り返しているが、他のワークロードは正常
- 監視ツール(Prometheus node exporterなど)のcgroupメトリクスのパスが変わってアラートが出る
- ログに
cgroup: ... not foundが出るが実際の影響がない
切り戻し手順はブートパラメータの変更を元に戻すだけです。/etc/default/grub の systemd.unified_cgroup_hierarchy=1 を削除して update-grub(または grub2-mkconfig)を実行し、再起動します。再起動前にはcordon+drainを忘れずに行います。
切り戻し後は必ず stat -fc %T /sys/fs/cgroup/ でv1に戻ったことを確認します。tmpfs が返ればhybridまたはv1の状態です。
よくあるつまずきとして、切り戻し後にkubeletのcgroupDriverが systemd のままになっているケースがあります。cgroupv1環境でdriverが systemd の場合、一部のKubernetesバージョンでは問題なく動作しますが、古いバージョンでは cgroupfs に戻す必要があります。切り戻し後は必ずkubeletのログを確認してください。
2026年現行環境での注意点と差分まとめ
2026年時点では、新規セットアップであればcgroupv2を前提とした構成が標準です。ただし既存クラスターの移行では次の差分に注意が必要です。
Kubernetes 1.25以降のcgroupv2 GA対応:Kubernetes 1.25でcgroupv2がGAになり、kubeletの CgroupsV2 フィーチャーゲートが削除されました。1.24以前の手順を参照していると、存在しないフィーチャーゲートを設定しようとしてエラーになります。現行バージョンでは意識する必要はありません。
RHEL 8系の扱い:RHEL 8(およびAlmaLinux 8・Rocky Linux 8)はデフォルトがcgroupv1(hybrid)のままです。cgroupv2に移行するには grubby --update-kernel=ALL --args="systemd.unified_cgroup_hierarchy=1" コマンドが使えます。GRUBの設定ファイルを手動編集するより確実です。
Podman・rootlessコンテナ:rootless Podmanはcgroupv2でリソース制限が正しく動作します。cgroupv1環境ではrootlessコンテナへのCPU・メモリ制限がサイレントに無視されるケースがあるため、rootless運用を採用している場合はcgroupv2への移行が特に効果的です。
監視スタックの更新:Prometheusのnode exporterやcAdvisorはcgroupv2対応のバージョンが必要です。cAdvisor 0.39以降、node exporter 1.3以降であれば問題ありません。移行後にメトリクスが取得できなくなった場合はこれらのバージョンを確認します。
seccomp・AppArmorとの組み合わせ:cgroupv2自体はseccompやAppArmorの設定に直接影響しませんが、カーネルアップグレードを伴う場合はセキュリティプロファイルの動作確認も合わせて行います。特にseccompのデフォルトプロファイルはカーネルバージョンによってシステムコールの扱いが変わることがあります。
cgroupv1からcgroupv2への移行は、コンテナランタイムのバージョン確認・kubeletのcgroupDriver統一・ローリング再起動・3段階の検証・切り戻し基準の事前定義という手順を踏むことで、本番環境でも安全に進められます。新規ノードをcgroupv2で追加しながら旧ノードを順次置き換える方法も有効で、一括切り替えのリスクを避けられます。
「コマンドは打てる。次は”現場で通用する型”を最短で身につけたい」——そんなあなたへ。
ネットの断片的なTipsをコピペするだけでは、体系的な運用スキルはなかなか積み上がりません。リナックスマスター.JPの無料メルマガ「リナマガ」では、現場で実際に使うLinuxサーバー運用の考え方を、順を追って実務目線でお届けしています。いま登録された方には、安全なサーバー構築の「型」をまとめた『Linuxサーバー構築入門マニュアル(図解60P)』を完全無料でプレゼント中です。
>> 図解60P『Linux入門マニュアル』を無料で受け取る
(メルマガ登録は10秒・いつでも解除OK)
※ 「独学の時間がもったいない」「プロから現場の技術を最短で学びたい」という本気の方には、2日で実務レベルが身につく初心者向けハンズオンセミナーもご用意しています。
PR・広告
[試して理解]Linuxのしくみ 増補改訂版(Amazon)
プロセス・権限・ファイルシステムなどLinux内部を図解で理解できる一冊。運用判断の勘所に。
※ Amazonのアソシエイトとして、当サイトは適格販売により収入を得ています。
