Docker是否支持cgroup v2的cpu.weight？如何配置及映射--cpu-shares？

1. Docker对cgroup v2 cpu.weight的支持 #

Docker完全适配cgroup v2的CPU权重配置，不需要直接传递cpu.weight参数——它会自动识别当前系统的cgroup版本，将你熟悉的--cpu-shares参数映射为对应层级的配置项：在cgroup v1环境下映射到cpu.shares，在cgroup v2环境下自动转换为cpu.weight。

2. 传递CPU权重的具体方法 #

• 使用--cpu-shares参数（推荐新手）：在cgroup v2环境下运行容器时，依然可以执行docker run --cpu-shares <数值>的命令，Docker会自动完成到cpu.weight的转换，无需额外操作。
• 自定义cgroup（进阶操作）：如果需要直接指定cpu.weight的精确数值，可以先在宿主机的cgroup v2层级下创建自定义cgroup，手动设置好cpu.weight的值，再通过docker run --cgroup-parent <自定义cgroup路径>让容器加入该cgroup。

3. cpu.weight与--cpu-shares的等效映射规则 #

两者的映射基于默认值的比例关系推导：

• cgroup v1中cpu.shares默认值为1024，对应cgroup v2中cpu.weight的默认值100000
• 转换公式：cpu.weight = (--cpu-shares数值 / 1024) * 100000
• 常见示例：
  • --cpu-shares=512 → cpu.weight=50000
  • --cpu-shares=2048 → cpu.weight=200000
  • --cpu-shares=1024 → cpu.weight=100000（默认值）

内容的提问来源于stack exchange，提问作者RaGa__M