Skip to content
Search AlmaLinux

This page uses Chinese content. Search opens the Chinese documentation.

    Browse this documentation

    AlmaLinux 10 cgroup v2 资源控制入门 — 统一层级、/sys/fs/cgroup 文件结构与 systemd CPUQuota/MemoryMax/IOWeight(容器实测)

    This content is not available in your language yet.

    在 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。

    三个只读命令(容器实测,almalinux:10,aarch64,2026-11-01):

    Terminal window
    cat /sys/fs/cgroup/cgroup.controllers
    stat -fc %T /sys/fs/cgroup
    cat /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 1
    cpu 0 82 1
    cpuacct 0 82 1
    blkio 0 82 1
    memory 0 82 1
    devices 0 82 1
    freezer 0 82 1
    net_cls 0 82 1
    perf_event 0 82 1
    net_prio 0 82 1
    pids 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.eventspopulated 1、frozen 0
    cgroup.freeze / cgroup.kill / cgroup.max.*冻结、批量杀、深度/数量上限

    控制器前缀 = 资源接口(实测样例):

    控制器实测接口文件
    cpucpu.idle cpu.max cpu.max.burst cpu.stat cpu.weight cpu.weight.nice
    cpusetcpuset.cpus(.effective/.exclusive/.partition) cpuset.mems(.effective)
    ioio.max io.stat
    memorymemory.current memory.high memory.low memory.max memory.min memory.oom.group memory.peak memory.reclaim memory.stat memory.swap.* memory.events(.local)
    pidspids.current pids.max pids.peak pids.events(.local)

    两个容易读错的点:

    1. cgroup.subtree_control 为空(实测 0 字节)说明没有控制器对这个容器的子组生效——本组自己的资源仍受宿主上层 cgroup 约束,但组内没有再分配。
    2. 控制器接口文件归父组所有(内核约定):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=主节流手段:超限强制直接回收,不触发 OOMmemory.high
    MemoryMax=绝对上限:压不住就在该单元内触发 OOM killer(官方建议 High 为主、Max 兜底)memory.max
    TasksMax=单元内任务数上限pids.max
    MemoryMin= / MemoryLow=内存保护(回收时优先保这组)memory.min / memory.low

    最省事的交付方式是 systemctl set-property,不用改单元文件(转述口径,未实测):

    Terminal window
    # 给一个服务限 CPU 与内存(持久化;加 --runtime 只改运行时)
    sudo systemctl set-property myapp.service CPUQuota=50% MemoryMax=1G
    # 给整个 slice 限(影响该组所有服务)
    sudo systemctl set-property user-1000.slice MemoryHigh=2G IOWeight=200
    systemctl show myapp.service --property=CPUQuota,MemoryMax

    v1 的对应属性(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):

    Terminal window
    ulimit -a # 进程 rlimits:open files 默认 1024
    ulimit -n 65535 # 子 shell 内提到 65535,读回 65535
    cat /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 选择与默认值按各自官方文档口径。