给Docker应用设置CPU和内存限额

同一台服务器运行多个容器时,可以给某个应用设置资源上限,减少它异常增长时对其他服务的影响。但上限过低也会带来请求变慢或内存不足退出,所以先了解正常用量,再选择限额,不直接照抄别人的数字。

本篇针对Linux Docker Engine及docker compose插件管理的普通项目,以单副本服务app为例,不使用Swarm的stack部署流程。服务名、容器名及数值都要替换;操作需要已有的Docker管理权限。

先记录当前状态和业务峰值

进入原项目目录。如果启动时带有-f、-p或其他项目选择参数,本文所有Compose命令都沿用相同参数,避免操作另一套项目:

docker compose version
docker compose config --services
docker compose ps --all
docker info

确认服务名确实为app,并从列表取得它的实际容器名。查看docker info中与cgroup、CPU、内存相关的支持情况和警告。rootless环境还要满足相应控制器的支持与委派条件;出现不支持或忽略限制的提示时,先处理条件,不能只凭YAML能保存就认定有效。

下面只读取目标容器的资源设置与当前用量。myapp-container是占位名称:

docker inspect --type container --format \
  'Image={{.Image}} NanoCPUs={{.HostConfig.NanoCpus}} Memory={{.HostConfig.Memory}}' \
  myapp-container
docker stats --no-stream myapp-container

记录当前镜像ID和旧限额。一次stats只是即时快照,额度还应参考正常高峰、启动和后台任务的监控记录。Linux上的stats内存显示会扣除部分缓存,不直接与程序RSS或整机free数值等同。

Memory为0表示没有设置这一项显式容器内存上限,并不代表整机无限。NanoCPUs为0时还可能存在cpu_quota、cpu_period或cpuset约束,需对照原配置,不能只凭这一个字段断言CPU完全未限制。分配预算时为系统、Docker和其他服务保留空间。

把上限写回服务的Compose配置

先保存原Compose文件与相关环境配置。下面只展示新增键的位置,加入已有app服务中,保留镜像、端口、卷和环境变量,不能拿这个片段覆盖完整文件:

services:
  app:
    cpus: 1.0
    mem_limit: 768m
示例设置 实际含义
cpus: 1.0 限制约1个CPU的计算时间配额,不是绑定某一颗核心,也不保证始终独占1核。
mem_limit: 768m 为这个容器设置768MiB的内存硬上限;应用超过可承受范围时可能触发OOM。

这两个值仅用于演示。CPU限额过低可能增加排队和延迟,内存限额应覆盖进程、运行时及正常峰值,不能只看空闲时的几十MB。多个副本会分别获得限额,不能把单容器限制当作整个项目的总预算。

普通Compose可以直接使用服务层的cpus与mem_limit。已有deploy.resources.limits时,同类数值应保持一致;已有cpu_quota等CPU配置也要先核对兼容关系,不叠加冲突参数。cpu_shares是竞争时的相对权重,不等于CPU硬上限。

本例没有修改swap策略。宿主机允许swap时,mem_limit不等于“内存加swap”的总上限;已有memswap_limit要一起核对。不要通过关闭OOM保护或依赖大量swap来掩盖内存预算不足。

安排重建,只应用到目标服务

Compose应用配置变更可能重建容器,目标应用会短暂中断。先确认数据已经持久化且有可恢复备份,不能把仅存于容器可写层的上传文件丢掉;可参照数据卷与目录挂载核对。

同时确认Compose仍引用当前镜像版本、本地已有该镜像、没有其他待发布改动,而且依赖服务已经运行。满足这些条件后,在维护窗口执行:

docker compose config -q &&
docker compose up -d --no-deps --no-build --pull never app

配置检查失败就不会继续。这里不构建、不拉取镜像、不启动依赖,只针对app应用当前配置。单纯执行docker restart不会把Compose文件中新加的限额读进去;也不需要先停止整个项目或删除数据卷。

检查新容器,再观察原来的业务负载

重建后重新查看docker compose ps --all,取得当前容器名,避免继续检查旧容器ID。用实际新名称执行:

docker inspect --type container --format \
  'NanoCPUs={{.HostConfig.NanoCpus}} Memory={{.HostConfig.Memory}} OOMKilled={{.State.OOMKilled}}' \
  myapp-container
docker stats --no-stream myapp-container
docker compose logs --since 5m --tail 80 app

按本例应看到NanoCPUs=1000000000、Memory=805306368,分别对应1个CPU配额和768MiB。先确认Docker实际保存的设置与预期一致,再检查平台没有忽略限制;仅看到配置文本不够。

恢复相近的正常业务负载,观察接口耗时、错误率、内存峰值和容器是否反复重启。不要在生产环境故意跑满内存来验证限额。若疑似OOM,结合发生时间与系统记录判断,不能只看退出码137;详见Linux OOM排查。

额度不合适时,按整机余量调整并重新验收;需要回退则恢复原Compose配置,在同样的维护条件下应用到app,再核对实际限额和业务。把最终数值保留在项目配置里,避免仅临时修改容器后,下次部署又恢复旧值。