Docker 中控制容器磁盘 IO 权重的正确参数是 --blkio-weight（范围10–1000，默认500），而非不存在的“Runtime-Constraint”；它仅对同一物理设备上的同步IO生效，需内核支持 blkio cgroup v1 且 Docker 使用兼容存储驱动。
Runtime-Constraint 不是 Docker 原生命名，实际要用 --blkio-weight
很多人搜 “Docker Runtime-Constraint IO 权重”，结果发现文档里根本没这个词——Docker 官方不叫 Runtime-Constraint，那是 Kubernetes 或某些 OCI 运行时的抽象概念。在纯 docker run 场景下，控制单个容器磁盘 IO 权重的唯一标准方式是 --blkio-weight 参数，它基于内核的 CFQ/CFQ-like 调度器（现多为 BFQ 或 mq-deadline 下的 blkio cgroup v1 机制）。
注意：--blkio-weight 只对同一块物理设备上的多个容器生效，且仅影响**同步读写（buffered I/O）**；直接 I/O（O_DIRECT）、内存映射文件（mmap）、或绕过 page cache 的操作基本不受控。
- 权重范围是
10–1000，默认值为500；设为0表示禁用权重控制（回退到无限制） - 必须使用支持 blkio cgroup 的内核（Linux ≥ 2.6.39，且编译时启用
CONFIG_BLK_CGROUP=y） - Docker daemon 启动时需确认
--storage-driver兼容：overlay2、btrfs 支持较好；devicemapper（legacy）已弃用，不建议用于 IO 控制
如何验证 --blkio-weight 是否真正生效
光加参数不等于起作用。常见失效场景包括：宿主机没挂载 blkio cgroup、容器运行时未正确继承、或测试方法本身绕过了控制路径。
实操验证步骤：
- 检查宿主机是否启用 blkio：运行
mount | grep blkio，应看到类似cgroup on /sys/fs/cgroup/blkio type cgroup (rw,nosuid,nodev,noexec,relatime,blkio) - 启动两个带不同权重的容器：
docker run --rm --name io-high --blkio-weight 800 ubuntu:22.04 sh -c "dd if=/dev/zero of=/tmp/test1 bs=4K count=100000 oflag=sync"和docker run --rm --name io-low --blkio-weight 200 ubuntu:22.04 sh -c "dd if=/dev/zero of=/tmp/test2 bs=4K count=100000 oflag=sync" - 进容器查实际分配值：
docker exec io-high cat /sys/fs/cgroup/blkio/blkio.weight应输出800；同理检查io-low - 关键：用
iotop -oP -d 1在宿主机观察两个容器进程的IO>列占比，高权重要明显高于低权重（非线性比例，但趋势必须可辨）
--blkio-weight-device 比全局 weight 更精细，但限制极多
如果想对某块设备（如 /dev/sdb）单独设权重，得用 --blkio-weight-device，格式是 --blkio-weight-device "/dev/sdb:800"。但它有硬性前提：
- 设备必须是“主从设备号”可识别的块设备（
ls -l /dev/sdb看是不是brw-rw----开头），LVM 逻辑卷、NVMe namespace（如/dev/nvme0n1p1）通常支持；ZFS dataset、overlay2 上层镜像层、或加密设备（dm-crypt）大概率不识别 - 权重只在该设备上与其他同样指定该设备的容器之间生效；若一个容器设了
/dev/sdb，另一个没设，则后者走默认权重（500），不参与该设备的相对调度 - 不能和
--blkio-weight混用：一旦用了--blkio-weight-device，全局--blkio-weight就被忽略
示例失败场景：docker run --blkio-weight-device "/dev/mapper/vg0-lv0:700" ... 很可能静默失败，因为内核无法将 device mapper 名称映射到实际主从号——此时 docker inspect 中看不到 BlkioWeightDevice 字段，且 /sys/fs/cgroup/blkio/blkio.weight_device 为空。
替代方案：当 --blkio-weight 失效或不够用时
真实生产环境常遇到权重“不起作用”的情况，本质是 blkio cgroup v1 在现代内核和存储栈中已被弱化。更可靠的做法是降级到速率限制（虽不是权重，但可控性强）：
- 用
--device-read-bps/--device-write-bps限速，例如：--device-write-bps /dev/sda:10mb，单位支持b、k、m、g - 该方式基于 cgroup v2 的 io.max 控制器（Docker 20.10+ 默认启用 v2），兼容性更好，且对 direct I/O 也部分生效
- 缺点：是硬上限而非相对权重，无法表达“A 是 B 的两倍快”这种关系；需预估业务 IO 峰值，否则容易限死
- 检查是否走 v2：
cat /proc/1/cgroup看第一行是否含0::/（v2）或8:blkio:（v1）；Docker 用 v2 时，--blkio-weight实际被忽略，必须改用--io-weight（cgroup v2 新参数，Docker 23.0+ 支持）
IO 权重控制本质上是个“尽力而为”的调度提示，不是强隔离。真要保障 SLO，得结合应用层限流、存储侧 QoS（如 Ceph 的 qos-spec、AWS EBS gp3 burst balance）、以及监控闭环（比如用 cadvisor 抓 container_fs_io_weighted_seconds_total 指标）。别指望一个命令解决所有问题。
