容器与云原生 / 系统课时
整理 Docker 上线检查清单
整理 Docker 上线检查清单
容器能启动,不等于适合上线。本节把镜像版本、运行用户、挂载、端口、日志、资源限制与恢复策略整理成一套可重复执行的检查流程,并用 Docker 命令逐项验证,避免上线前只凭配置文件“看起来没问题”。
学习目标
- 能把 Docker 上线检查拆成镜像、权限、存储、网络、日志、资源与恢复七类项目。
- 能用
docker inspect、docker image inspect和运行时命令核对实际生效状态。 - 能形成可复用的上线前验收顺序,并明确每项检查失败时是否应阻止发布。
先检查不可变信息
上线前首先确认“运行的到底是什么”。生产环境应避免依赖浮动标签,例如仅写 latest;更稳妥的做法是固定经过验证的版本标签,并记录镜像摘要。
假设待检查容器名为 web-prod,先执行:
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 会不同。
image=<IMAGE>:<VERSION> user=<USER>
id=sha256:<ID> digests=["<IMAGE>@sha256:<DIGEST>"]如果 user= 为空,不代表一定有问题,但通常表示镜像沿用镜像内默认用户;如果镜像默认是 root,就需要确认这是否是应用真正需要的权限。
核对端口、挂载和运行用户
接下来检查最容易造成“服务能启动但暴露错误”或“数据落错位置”的运行参数。
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、路径和端口会因应用而不同。
ports={"<CONTAINER_PORT>/tcp":[{"HostIp":"<HOST>","HostPort":"<PORT>"}]}
<mount-type> <source> -> <destination> <true-or-false>
PID USER COMMAND
<PID> <USER> <PROCESS>挂载检查至少要确认三件事:源路径或 Volume 名正确、读写模式符合预期、容器内目标路径与应用配置一致。数据库、上传文件等状态数据不能依赖容器可写层长期保存。
检查日志和资源边界
日志必须能被收集,也要防止无限增长。先确认日志驱动与日志文件位置,再查看资源限制。
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 通常表示对应资源没有设置硬限制,应结合部署标准判断是否可接受。
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;没有健康检查时,则至少执行一次真实业务探测。
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。
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 |
| 恢复 | 重启策略、备份、回滚路径已验证 | 故障演练与恢复测试 |
最后做一次汇总式检查,便于在发布记录中留证。
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预期结果应同时确认目标容器名称、镜像版本、运行用户、重启策略、内存限制和运行状态。动态值以实际环境为准。
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真正可复用的上线流程,应以“实际生效配置可验证、故障后可恢复”为验收标准。任何涉及镜像来源不明、数据未持久化、关键端口误暴露或没有恢复路径的问题,都应在发布前处理完毕。