AlmaLinux 10 cgroup v2 资源控制入门 — 统一层级、/sys/fs/cgroup 文件结构与 systemd CPUQuota/MemoryMax/IOWeight(容器实测)
在 almalinux:10 容器(aarch64;10.2「Lavender Lion」,镜像 almalinux:10@sha256:5a4b41a4…cfe8,2026-11-01)中实际执行:cgroup.controllers 与 stat -fc %T 的 v2 确认、/proc/cgroups 读取与口径核对、cgroup.controllers / cgroup.subtree_control / cgroup.procs / cgroup.type / cgroup.stat / cgroup.events 六个核心接口文件逐个读取、systemctl show --property=CPUQuota --all 与 systemctl set-property 的报错原文记录、systemd.resource-control man 页落盘情况核对、ulimit -a 采样与子 shell 提限、/sys/fs/cgroup 全量条目清点、uname -r 内核归属补采。原始日志:plans/content-expansion/evidence/logs/alma-cgroup-v2.log(六个 step 均为独立 docker run --rm 容器,bash -x 原始输出)。
本页没有执行:systemd 运行时(容器以 bash 为 PID 1,systemctl 只能记录报错)、set-property 的实际生效与落盘、真实 OOM 联动——这些标注「未实测」,见文末「未验证事项」。
cgroup v1 与 v2:统一层级的核心区别
Section titled “cgroup v1 与 v2:统一层级的核心区别”v1 和 v2 的分水岭不是「多几个控制器」,而是层级组织方式(文献口径,内核 cgroup v2 官方文档):
- v1:多层级。允许同时存在任意多个层级,每个层级挂任意控制器组合;实践中因为控制器不能跨层级复用、迁移困难,多数配置退化成「每个控制器一个层级」,userland 要在多条相似层级上重复同样的管理操作。
- v2:单一统一层级。内核文档原话是 “Unlike v1, cgroup v2 has only single hierarchy”——所有支持 v2 的控制器都挂在这一棵树上,管理面只有一套接口文件。
- 按需启用。v2 默认不启用任何控制器;要对某组的子组分配某类资源,就往该组的
cgroup.subtree_control写+cpu +memory -io这样的开关(要么全成功要么全失败)。 - 自上而下(top-down)。资源只能从父组分下来:子组想启用某控制器,父组的
cgroup.subtree_control必须已经启用它。 - no internal process constraint。非根 cgroup 自身有进程时,不能在它的
cgroup.subtree_control里启用域控制器——进程只能落在叶子上,消除「父组进程和子组抢资源」这类 v1 说不清的竞争。 /proc/cgroups对 v2 无意义。内核文档在 Deprecated v1 Core Features 里明示:/proc/cgroups is meaningless for v2,要看可用控制器请读根的cgroup.controllers。
这套约定直接决定了下一节的实测读法:判断「是不是 v2」「有哪些控制器」,读接口文件,不要读 /proc/cgroups。
EL10 实测:cgroup v2 是默认层级
Section titled “EL10 实测:cgroup v2 是默认层级”三个只读命令(容器实测,almalinux:10,aarch64,2026-11-01):
cat /sys/fs/cgroup/cgroup.controllersstat -fc %T /sys/fs/cgroupcat /proc/cgroups实测输出(日志 step-1):
cpuset cpu io memory pids # cgroup.controllers:五个控制器cgroup2fs # stat:挂的是 v2 文件系统#subsys_name hierarchy num_cgroups enabled # /proc/cgroups 表头cpuset 0 82 1cpu 0 82 1cpuacct 0 82 1blkio 0 82 1memory 0 82 1devices 0 82 1freezer 0 82 1net_cls 0 82 1perf_event 0 82 1net_prio 0 82 1pids 0 82 1 # 共 11 个 legacy 子系统行,hierarchy 全 0怎么读这三段输出:
cgroup.controllers列出 cpuset cpu io memory pids 五个控制器——这是 v2 统一层级的权威清单;stat -fc %T报cgroup2fs,说明运行时把/sys/fs/cgroup挂成了 v2 文件系统;/proc/cgroups虽然列出 11 个子系统行(hierarchy 全 0、enabled 全 1),但按内核文档它对 v2 无意义——里面出现 cpuacct、blkio、net_cls 这些 v1 名字不代表 v2 在用它们,别拿这个文件数控制器。
容器内的用户态组件:rpm -q systemd 实测 systemd-257-23.el10_2.2.alma.1(aarch64)——EL10 用户态就是按统一层级设计的 systemd 257 系(文献口径:systemd 资源控制属性只面向 v2,v1 专属选项已废弃,见下文)。
内核归属的诚实边界:容器共享宿主内核,本日志实测 uname -r 是宿主的 7.2.12-orbstack-…(Debian 13/OrbStack),不是 EL10 内核。所以「AlmaLinux 10 发行内核为 6.12、默认走 v2」是文献口径(systemd 统一层级默认 + 官方发行说明),本页实测证明的是 EL10 用户态包面(systemd 257、systemctl、v2 接口文件名体系)与本次运行时的 cgroup2fs 视图——两者相互印证但不等同。
/sys/fs/cgroup 的文件结构(实测)
Section titled “/sys/fs/cgroup 的文件结构(实测)”ls /sys/fs/cgroup | wc -l 实测 49 个条目,按前缀分两类(日志 step-5):
cgroup. 开头 = 核心接口(任何 cgroup 都有,与控制器无关):
| 文件 | 作用 |
|---|---|
cgroup.controllers | 本组可启用的控制器清单 |
cgroup.subtree_control | 对子组启用的控制器开关(实测为空:0 字节) |
cgroup.procs | 本组进程 PID 清单(实测 2 个 PID) |
cgroup.threads | 线程粒度清单(threaded 模式用) |
cgroup.type | 组类型(实测 domain) |
cgroup.stat / cgroup.stat.local | 子组数、各控制器启用计数 |
cgroup.events | populated 1、frozen 0 |
cgroup.freeze / cgroup.kill / cgroup.max.* | 冻结、批量杀、深度/数量上限 |
控制器前缀 = 资源接口(实测样例):
| 控制器 | 实测接口文件 |
|---|---|
| cpu | cpu.idle cpu.max cpu.max.burst cpu.stat cpu.weight cpu.weight.nice |
| cpuset | cpuset.cpus(.effective/.exclusive/.partition) cpuset.mems(.effective) |
| io | io.max io.stat |
| memory | memory.current memory.high memory.low memory.max memory.min memory.oom.group memory.peak memory.reclaim memory.stat memory.swap.* memory.events(.local) |
| pids | pids.current pids.max pids.peak pids.events(.local) |
两个容易读错的点:
cgroup.subtree_control为空(实测 0 字节)说明没有控制器对这个容器的子组生效——本组自己的资源仍受宿主上层 cgroup 约束,但组内没有再分配。- 控制器接口文件归父组所有(内核约定):
cpu.max这些文件出现在子组目录里,是父组「对子组分配 cpu」的结果。所以「目录里有io.max」不等于「io 控制器已对本组启用」——本容器io.max/io.stat就在清单里,而subtree_control是空的。
systemd 资源控制:CPUQuota / MemoryMax / IOWeight
Section titled “systemd 资源控制:CPUQuota / MemoryMax / IOWeight”systemd 不让你直接写 /sys/fs/cgroup 的接口文件,而是提供一层属性,由 systemd 负责落到对应文件(文献口径,freedesktop 官方 systemd.resource-control(5);属性→文件映射与容器实测的文件名一一对应):
| systemd 属性 | 含义 | 落到的接口文件 |
|---|---|---|
CPUQuota=20% | 单核 20% 的 CPU 上限;>100% 覆盖多核 | cpu.max |
CPUWeight= / IOWeight= | 相对权重,1–10000,默认 100(权重型分配) | cpu.weight / io.weight |
MemoryHigh= | 主节流手段:超限强制直接回收,不触发 OOM | memory.high |
MemoryMax= | 绝对上限:压不住就在该单元内触发 OOM killer(官方建议 High 为主、Max 兜底) | memory.max |
TasksMax= | 单元内任务数上限 | pids.max |
MemoryMin= / MemoryLow= | 内存保护(回收时优先保这组) | memory.min / memory.low |
最省事的交付方式是 systemctl set-property,不用改单元文件(转述口径,未实测):
# 给一个服务限 CPU 与内存(持久化;加 --runtime 只改运行时)sudo systemctl set-property myapp.service CPUQuota=50% MemoryMax=1G# 给整个 slice 限(影响该组所有服务)sudo systemctl set-property user-1000.slice MemoryHigh=2G IOWeight=200systemctl show myapp.service --property=CPUQuota,MemoryMaxv1 的对应属性(BlockIOWeight=、CPUShares= 等)自 systemd 252 起已全部废弃——EL10 上写资源控制只用上表这套 v2 属性,不用再考虑 v1 兼容写法。
容器里这条命令的真实行为被记录到一半(日志 step-3,报错原文):
System has not been booted with systemd as init system (PID 1). Can't operate.Failed to connect to system scope bus via local transport: Host is down # rc=1即:systemctl show/set-property 都因 systemd 未运行被拒——set-property 的落盘行为(system.control drop-in)与 CPUQuota/MemoryMax/IOWeight 的实际生效路径未实测,需要实机 VM。另注:systemd.resource-control 的 man 页在最小化镜像里只有 rpm 清单登记、文件未落盘(zcat 报 No such file or directory),本节口径以 freedesktop 在线文档为准。
ulimit 与 cgroup:两套独立的限制机制
Section titled “ulimit 与 cgroup:两套独立的限制机制”排错时最常见的混淆:把 ulimit(rlimit)当 cgroup 用。两者机制完全不同(容器实测对照,日志 step-4):
ulimit -a # 进程 rlimits:open files 默认 1024ulimit -n 65535 # 子 shell 内提到 65535,读回 65535cat /sys/fs/cgroup/memory.max # 对照:cgroup 侧 memory.max 独立存在,值 max| ulimit(rlimit) | cgroup | |
|---|---|---|
| 作用对象 | 单个进程及其子进程(属性继承) | 一组进程(内核按组层级统计) |
| 谁设定 | shell ulimit、服务 unit 的 LimitNOFILE= 等 Limit*= 行 | systemd MemoryMax= 等属性,或直写接口文件 |
| 超限后果 | 调用失败(如 EMFILE) | 回收/节流,硬上限触发组内 OOM killer |
| 典型用途 | 文件描述符数、栈大小、core 大小 | 内存、CPU 份额、I/O、进程数 |
对应到服务管理:限内存用 MemoryMax(cgroup),限文件描述符才用 LimitNOFILE(rlimit)——给 MemoryMax 调大解决不了 Too many open files,反过来也一样。
Docker/Podman 的 cgroup driver 关系(文献口径,未实测)
Section titled “Docker/Podman 的 cgroup driver 关系(文献口径,未实测)”容器运行时是 cgroup 的另一个「客户」:它把容器进程放进自己的 cgroup 子树。文献口径上有两种 cgroup driver:
- systemd driver:容器子树挂在 systemd 管理的 slice 树(
system.slice/docker-id.scope这类)下,与宿主 systemd 资源控制同一套层级——EL10 这种「systemd + cgroup v2」主机上的对齐选择; - cgroupfs driver:运行时自己直写
/sys/fs/cgroup,绕过 systemd,两边可能互相改写对方的子树。
Podman 在 systemd 主机上默认走 systemd manager;Docker 需要在 daemon 配置里显式选 native.cgroupdriver=systemd(较新版本已默认)。本容器环境没有 dockerd/podman 运行时,driver 的实际落点未实测,此节只作概念衔接:判断一台 EL10 主机上容器资源限制「归谁管」,先看运行时用的哪个 driver,再看 systemd-cgls 的树里有没有对应的 scope。
- systemd 运行时:容器无 systemd——
systemctl set-property的落盘(system.control drop-in)、CPUQuota/MemoryMax/IOWeight的实际生效、systemctl show读回属性值均未实测,本页按官方文档口径转述。 - 真实 OOM 联动:
MemoryMax触发单元内 OOM killer、MemoryHigh节流表现、memory.events的oom_kill计数增长需要实机压内存观察。 - cgroup namespace 与委托边界:
cgroupns=private只给出本容器视图;宿主 slice 树布局、nsdelegate、Delegate=子树的授权隔离不在容器验证范围。 - 内核归属:容器共享宿主内核(本机 Debian 13/OrbStack 7.2.12),「EL10 内核 6.12、默认 v2」为文献口径,需在原生 EL10 实机上用
uname -r复核。 - Docker/Podman cgroup driver:实际落点未实测,driver 选择与默认值按各自官方文档口径。