cgroupv2とは何か、v1との根本的な違い
cgroup(Control Groups)はLinuxカーネルがプロセスのCPU・メモリ・I/Oなどのリソース使用量を制御する仕組みです。v1では複数の「サブシステム(コントローラー)」がそれぞれ独立した階層を持つ設計でしたが、cgroupv2では単一の統合階層(Unified Hierarchy)に整理されました。
この設計変更により、v1特有の「同一プロセスが複数の階層に分散して管理される」複雑さが解消されています。systemdはv2の統合階層を活かしてよりきめ細かいサービス単位のリソース管理を実現しており、コンテナランタイムもv2の新APIを前提とした機能を追加しています。
主な技術的差分は次のとおりです。
- プロセスはリーフcgroupにのみ所属可能:v1では中間ノードにもプロセスを配置できましたが、v2ではリーフのみが許可されます。
- スレッドモードの追加(Thread mode):スレッド単位のリソース割り当てがv2で初めてサポートされました。
- PSI(Pressure Stall Information):v2専用のリソース圧迫度モニタリングです。eBPFと組み合わせた運用監視への活用が進んでいます。
- ioコントローラーの統合:v1でblkio/cfqとして分散していたI/O制御がioコントローラーに統合されました。
2026年時点の標準化状況と対応ディストリビューション
2026年現在、主要ディストリビューションはほぼcgroupv2をデフォルトに移行しています。
- RHEL 9 / Rocky Linux 9 / AlmaLinux 9:cgroupv2がデフォルト。v1はカーネルパラメーターで手動指定が必要です。
- Ubuntu 22.04 LTS以降:cgroupv2統一階層がデフォルトです。
- Debian 11以降:v2が標準です。
- Fedora 31以降:もっとも早期にv2へ移行しており、現在もv2が標準です。
コンテナランタイム側では、Docker 20.10以降・containerd 1.4以降・CRI-O 1.20以降がv2に対応しています。Kubernetes側ではv1.25以降でcgroupv2対応が安定化し、v1.28以降でv2前提の機能拡張が継続しています。運用環境でKubernetes 1.26以前を維持している場合は、ランタイムバージョンの整合性を先に確認してください。
現在のcgroupバージョンは次のコマンドで確認できます。
# ファイルシステムタイプで確認
mount | grep cgroup
# または
stat -fc %T /sys/fs/cgroup/
cgroup2fsと表示されればv2、tmpfsであればv1またはハイブリッドです。
コンテナワークロードへの影響と移行前の検証手順
cgroupv2への移行でもっとも注意が必要なのは、v1固有の機能を使っているコンテナイメージや起動設定です。
影響が出やすい構成の確認
- v1 memoryコントローラー依存:
memory.memsw.limit_in_bytesなどv1固有のパラメーターをコンテナ起動オプションで指定している場合、v2では無視またはエラーになります。 - 旧来のJVMヒープ検出:Java 8u191以前・Java 11初期バージョンはv2の統合階層からのメモリ上限読み取りに失敗することがあります。現在サポート対象のJava 11u20以降・Java 17以降では修正済みです。
- cgroup-parentの明示指定:Compose・Swarmなどでcgroupのパスをハードコードしている設定は、v2でパス構造が変わるため無効になる場合があります。
ステージング環境での検証ステップ
本番移行の前にステージング環境で以下の手順を踏んでおくと、移行時の問題の大半を事前に検出できます。
- ステージング環境をcgroupv2に切り替えたうえで、既存コンテナ定義をそのまま起動し、起動エラー・OOMキルの有無を確認します。
systemd-cgls・systemd-cgtopでリソース割り当てが期待どおりになっているか検証します。- JVMアプリはヒープサイズが自動検出されているかログで確認します(
-XX:+UseContainerSupportが有効かどうかが目安です)。 - PSIメトリクス(
/sys/fs/cgroup/memory.pressureなど)をPrometheusなどで収集できるか確認します。
systemdワークロードへの影響とリソース管理の再確認
systemdはv2対応が進んでおり、systemd 248以降(RHEL 9・Ubuntu 22.04が搭載)ではv2統合階層を前提とした動作が標準です。v1からv2に切り替えると以下の点で挙動が変わります。
ユニットファイルのCPU・メモリ設定
v1時代に使われていたCPUShares=はv2では非推奨となり、CPUWeight=(デフォルト100、範囲1~10000)に置き換わっています。MemoryLimit=もMemoryMax=への移行が推奨されます。移行済みかどうかは次のコマンドで確認できます。
systemctl show -p CPUWeight,MemoryMax <サービス名>
CPUWeight=やMemoryMax=が反映されていれば、v2対応の設定が機能しています。旧来のCPUShares=指定はカーネル側で無視されますが、エラーにはなりません。サービスのリソース管理を確実に効かせるには、明示的に新パラメーターへ書き換えることが必要です。
ユーザーセッションのcgroup委任(Delegation)
v2ではrootless Docker・Podman・rootless containerdなどが必要とするcgroup委任をユーザーセッション単位で設定できます。/etc/systemd/system/user@.service.d/にdelegateドロップインを追加するか、loginctl enable-lingerと組み合わせる方法が標準的です。v1環境でこれらを独自スクリプトで制御していた場合は、v2移行後にsystemdの機能へ置き換えることが推奨されます。
移行手順・切り戻し設計と注意点
RHEL 8やUbuntu 20.04のようにv1・v2ハイブリッドや純粋v1の環境をv2専用に切り替えるには、GRUBのカーネルパラメーターを変更します。
# RHEL/Rocky/AlmaLinux系(grubbyを使う)
grubby --update-kernel=ALL --args="systemd.unified_cgroup_hierarchy=1"
# Ubuntu/Debian系(/etc/default/grub の GRUB_CMDLINE_LINUX_DEFAULT に追記後)
update-grub
再起動後、stat -fc %T /sys/fs/cgroup/がcgroup2fsを返せば移行完了です。移行後は以下を確認します。
- Dockerデーモンが
cgroupDriver: systemdで起動しているか(docker info | grep -i cgroup)。 - KubernetesノードのkubeletがcgroupDriverをsystemdに設定しているか(kubelet設定ファイルまたは
--cgroup-driverオプション)。 - コンテナ起動時にOOMキルが発生していないか(
journalctl -k | grep -i oom)。
切り戻し手順
問題が発覚した際にすばやくv1に戻せる準備をしておくことが重要です。カーネルパラメーターの変更と再起動だけで切り戻せるため、手順自体は単純です。
# RHEL系
grubby --update-kernel=ALL --remove-args="systemd.unified_cgroup_hierarchy=1"
grubby --update-kernel=ALL --args="systemd.unified_cgroup_hierarchy=0"
# Ubuntu系
# GRUB_CMDLINE_LINUX_DEFAULT からパラメーターを削除し update-grub 後に再起動
再起動後にstat -fc %T /sys/fs/cgroup/がtmpfsを返せばv1に戻っています。コンテナランタイムのキャッシュやvolumeデータはcgroupバージョンと無関係なので、切り戻しによるデータ損失は発生しません。
よくあるつまずきと対処
- 「cgroupv2 not supported」エラー:Docker 19.03以前はv2未対応です。Docker 20.10以上へのアップデートが必要です。
- Kubernetesノードが
NotReadyになる:kubeletのcgroupDriverがcgroupfsのままの場合、v2環境では起動に失敗します。cgroupDriver: systemdに統一してください。 - PSIメトリクスが取得できない:Kernel 4.20以上が必要です。また
/proc/sys/kernel/psiが0になっているとPSIは無効です。カーネルパラメーターにpsi=1を追加してください。 - スワップ制御の挙動が変わった:v2ではmemoryとswapが分離管理されます。
MemorySwapMax=を明示的に設定しないと、一般的にはスワップが無制限になるケースがあるため注意が必要です。
cgroupv2への移行は単なるバージョンアップではなく、プロセスツリー全体のリソース管理モデルの刷新です。コンテナ・systemdの両面で事前検証を行い、切り戻し手順を確認したうえで本番適用することで、移行リスクを最小化できます。2026年現在、RHEL 9世代以降の環境ではv2が前提となっており、v1依存の設定を持つシステムの棚卸しが喫緊の課題となっています。
「コマンドは打てる。次は”現場で通用する型”を最短で身につけたい」——そんなあなたへ。
ネットの断片的なTipsをコピペするだけでは、体系的な運用スキルはなかなか積み上がりません。リナックスマスター.JPの無料メルマガ「リナマガ」では、現場で実際に使うLinuxサーバー運用の考え方を、順を追って実務目線でお届けしています。いま登録された方には、安全なサーバー構築の「型」をまとめた『Linuxサーバー構築入門マニュアル(図解60P)』を完全無料でプレゼント中です。
>> 図解60P『Linux入門マニュアル』を無料で受け取る
(メルマガ登録は10秒・いつでも解除OK)
※ 「独学の時間がもったいない」「プロから現場の技術を最短で学びたい」という本気の方には、2日で実務レベルが身につく初心者向けハンズオンセミナーもご用意しています。
PR・広告
[試して理解]Linuxのしくみ 増補改訂版(Amazon)
プロセス・権限・ファイルシステムなどLinux内部を図解で理解できる一冊。運用判断の勘所に。
※ Amazonのアソシエイトとして、当サイトは適格販売により収入を得ています。
