Docker CLI 中关于 cgroup2 交换空间限制警告的技术解析

问题背景

在 Docker 27.5.1 版本中，当系统使用 cgroup2 且运行在非 systemd 环境下时，用户执行 docker info 命令可能会看到"WARNING: No swap limit support"的警告信息。这种现象主要出现在 Debian 12 系统上，特别是那些移除了 systemd 并使用 sysvinit 作为初始化系统的环境。

技术原理分析

cgroup2 是 Linux 控制组的最新实现，相比 cgroup1 提供了更统一和简化的资源管理方式。在 cgroup2 架构下，内存控制子系统已经包含了交换空间(swap)的管理功能。然而，Docker 在检测系统是否支持交换空间限制时，其逻辑可能在某些特定环境下无法正确识别 cgroup2 的交换空间支持能力。

解决方案详解

1. 手动挂载 cgroup2 文件系统

首先需要确保 cgroup2 文件系统正确挂载。可以通过以下命令实现：

mount -t cgroup2 cgroup2 /sys/fs/cgroup -o rw,nosuid,nodev,noexec,relatime,nsdelegate,memory_recursiveprot

这个命令将 cgroup2 挂载到 /sys/fs/cgroup 目录，并设置了适当的挂载选项，其中 memory_recursiveprot 选项对于内存控制特别重要。

2. 创建专用控制组

使用 cgroup-tools 工具包中的 cgcreate 命令为 Docker 创建专用的控制组：

cgcreate -g cpuset,cpu,io,memory,pids:/docker

这条命令创建了一个名为"docker"的控制组，并启用了 CPU 集、CPU、I/O、内存和进程 ID 等资源控制器。创建成功后，在 /sys/fs/cgroup/docker/ 目录下可以看到各种控制文件。

3. 在控制组中启动 Docker

使用 cgexec 命令在创建的控制组中启动 Docker 服务：

cgexec -g cpuset,cpu,io,memory,pids:/docker /etc/init.d/docker start

这种方式确保 Docker 及其所有子进程都在指定的控制组中运行，从而能够正确识别和使用 cgroup2 的所有功能，包括交换空间限制。

技术验证

实施上述解决方案后，可以通过以下方式验证：

1. 再次运行 docker info 命令，确认警告信息已消失
2. 检查 /sys/fs/cgroup/docker/ 目录下的控制文件，特别是与内存和交换空间相关的文件
3. 创建测试容器并设置内存和交换空间限制，验证限制是否生效

深入理解

这个问题的本质在于 Docker 在非 systemd 环境下对 cgroup2 功能的检测机制。通过手动创建控制组并明确指定资源控制器，我们实际上是在帮助 Docker 正确识别系统的能力。这种方法不仅解决了交换空间限制的警告问题，还为 Docker 提供了更精确的资源控制能力。

最佳实践建议

1. 在生产环境中，建议将这些配置写入系统启动脚本，确保每次重启后自动生效
2. 考虑使用更精细的资源控制策略，为不同类型的容器工作负载创建不同的控制组
3. 定期检查 cgroup2 的文档更新，了解新功能和改进
4. 监控容器的资源使用情况，确保资源限制设置合理

总结

通过理解 cgroup2 的工作原理和 Docker 的资源管理机制，我们可以有效地解决"WARNING: No swap limit support"的警告问题。这种方法不仅适用于 Debian 12 系统，对于其他使用 cgroup2 的非 systemd Linux 发行版也有参考价值。正确配置 cgroup2 不仅能消除警告信息，还能为容器提供更可靠的资源隔离保障。