容器与云原生 / 系统课时

整理 Docker 上线检查清单

整理 Docker 上线检查清单

容器能启动,不等于适合上线。本节把镜像版本、运行用户、挂载、端口、日志、资源限制与恢复策略整理成一套可重复执行的检查流程,并用 Docker 命令逐项验证,避免上线前只凭配置文件“看起来没问题”。

学习目标

  • 能把 Docker 上线检查拆成镜像、权限、存储、网络、日志、资源与恢复七类项目。
  • 能用 docker inspect、docker image inspect 和运行时命令核对实际生效状态。
  • 能形成可复用的上线前验收顺序,并明确每项检查失败时是否应阻止发布。

先检查不可变信息

上线前首先确认“运行的到底是什么”。生产环境应避免依赖浮动标签,例如仅写 latest;更稳妥的做法是固定经过验证的版本标签,并记录镜像摘要。

假设待检查容器名为 web-prod,先执行:

bash
docker inspect web-prod --format 'image={{.Config.Image}} user={{.Config.User}}'
docker image inspect "$(docker inspect web-prod --format '{{.Image}}')" --format 'id={{.Id}} digests={{json .RepoDigests}}'

预期结果应能明确看到镜像引用、运行用户、镜像 ID 和仓库摘要。不同环境中的摘要与 ID 会不同。

text
image=<IMAGE>:<VERSION> user=<USER>
id=sha256:<ID> digests=["<IMAGE>@sha256:<DIGEST>"]

如果 user= 为空,不代表一定有问题,但通常表示镜像沿用镜像内默认用户;如果镜像默认是 root,就需要确认这是否是应用真正需要的权限。

核对端口、挂载和运行用户

接下来检查最容易造成“服务能启动但暴露错误”或“数据落错位置”的运行参数。

bash
docker inspect web-prod --format 'ports={{json .NetworkSettings.Ports}}'
docker inspect web-prod --format '{{range .Mounts}}{{println .Type .Source "->" .Destination .RW}}{{end}}'
docker top web-prod -eo pid,user,comm

预期结果应该与部署设计一致:只发布必要端口,持久化目录指向预期位置,PID 1 使用预期账号。实际 UID、GID、路径和端口会因应用而不同。

text
ports={"<CONTAINER_PORT>/tcp":[{"HostIp":"<HOST>","HostPort":"<PORT>"}]}
<mount-type> <source> -> <destination> <true-or-false>
PID USER COMMAND
<PID> <USER> <PROCESS>

挂载检查至少要确认三件事:源路径或 Volume 名正确、读写模式符合预期、容器内目标路径与应用配置一致。数据库、上传文件等状态数据不能依赖容器可写层长期保存。

检查日志和资源边界

日志必须能被收集,也要防止无限增长。先确认日志驱动与日志文件位置,再查看资源限制。

bash
docker inspect web-prod --format 'log-driver={{.HostConfig.LogConfig.Type}} log-options={{json .HostConfig.LogConfig.Config}}'
docker inspect web-prod --format 'memory={{.HostConfig.Memory}} nano-cpus={{.HostConfig.NanoCpus}} pids-limit={{.HostConfig.PidsLimit}} restart={{.HostConfig.RestartPolicy.Name}}'

预期结果会显示当前日志驱动、限制值和重启策略。数值为 0 通常表示对应资源没有设置硬限制,应结合部署标准判断是否可接受。

text
log-driver=<LOG_DRIVER> log-options=<LOG_OPTIONS>
memory=<BYTES> nano-cpus=<NANO_CPUS> pids-limit=<PIDS_LIMIT> restart=<RESTART_POLICY>

资源限制的目的不是让应用“尽量少用”,而是让单个容器异常时不会无限挤占宿主机。对于关键服务,还应给监控系统配置 CPU、内存、磁盘和重启次数告警。

验证健康状态与恢复策略

有健康检查时,不能只看 docker ps 中的 Up。应检查 State.Health;没有健康检查时,则至少执行一次真实业务探测。

bash
docker inspect web-prod --format 'status={{.State.Status}} health={{if .State.Health}}{{.State.Health.Status}}{{else}}not-configured{{end}}'
curl -fsS http://127.0.0.1:<PORT>/<HEALTH_PATH>

预期结果应是容器处于运行状态,并且业务探测成功。若没有配置 Docker Healthcheck,第一条命令会显示 not-configured。

text
status=running health=<healthy-or-not-configured>
<HEALTH_RESPONSE>

恢复策略还要回答两个问题:容器退出后是否会按预期重启,宿主机或节点故障后数据如何恢复。restart 策略只能处理部分进程级故障,不能代替数据备份、异地副本或发布回滚方案。

形成可复用的上线清单

把检查项固定下来,比每次凭经验临时想更可靠。以下清单适合放进发布工单或流水线人工审核项:

检查项 必须确认的事实 常用验证方式
镜像 版本固定、摘要可追溯 docker inspect、docker image inspect
用户 不使用非必要高权限账号 docker inspect、docker top
挂载 数据路径、读写模式、权限正确 docker inspect
端口 只暴露必要端口,绑定地址符合设计 docker inspect
日志 可采集且有轮转或外部接管 检查日志驱动与选项
资源 CPU、内存、PID 等边界符合容量设计 docker inspect
恢复 重启策略、备份、回滚路径已验证 故障演练与恢复测试

最后做一次汇总式检查,便于在发布记录中留证。

bash
docker inspect web-prod --format 'name={{.Name}} image={{.Config.Image}} user={{.Config.User}} restart={{.HostConfig.RestartPolicy.Name}} memory={{.HostConfig.Memory}}'
docker ps --filter name=web-prod

预期结果应同时确认目标容器名称、镜像版本、运行用户、重启策略、内存限制和运行状态。动态值以实际环境为准。

text
name=/web-prod image=<IMAGE>:<VERSION> user=<USER> restart=<RESTART_POLICY> memory=<BYTES>
CONTAINER ID   IMAGE               STATUS        PORTS      NAMES
<ID>           <IMAGE>:<VERSION>   Up <TIME>     <PORTS>    web-prod

真正可复用的上线流程,应以“实际生效配置可验证、故障后可恢复”为验收标准。任何涉及镜像来源不明、数据未持久化、关键端口误暴露或没有恢复路径的问题,都应在发布前处理完毕。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

整理 Docker 上线检查清单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通