容器与云原生 / 系统课时
整理 Compose 上线检查清单
整理 Compose 上线检查清单
Compose 文件能够启动,并不代表系统已经具备上线条件。本节把镜像版本、端口、Volume、环境变量、健康检查、日志和备份整理成一套可执行的发布前检查顺序,让多服务系统在真正切流量前暴露常见配置风险。
学习目标
- 建立覆盖镜像、网络入口、持久化数据与运行配置的上线检查清单。
- 使用 Compose 自带能力验证配置解析结果,避免带着语法或变量错误发布。
- 明确健康检查、日志和备份的验收标准,使发布后具备故障发现与恢复能力。
先验证 Compose 配置能否被完整解析
上线检查应从最终生效的 Compose 配置开始,而不是只阅读 compose.yaml。Compose 会进行环境变量替换、文件合并和默认值处理,因此源码看起来正确,解析后的结果仍可能出现变量缺失或配置冲突。
在包含 Compose 配置的项目目录执行:
set -euo pipefail
docker compose config --quiet
printf 'compose-config: OK\n'预期输出:
compose-config: OK只有 docker compose config --quiet 成功退出后才会打印上述内容。如果变量无法解析、YAML 结构错误或合并配置无效,命令会直接失败,应先修正配置再进入后续上线检查。
检查镜像、端口和持久化数据
这三项决定发布的版本、外部暴露面以及容器重建后数据是否仍然存在。检查时不要只确认字段“已经填写”,而要确认它们符合生产环境的预期。
| 检查项 | 上线前应确认 | 常见风险 |
|---|---|---|
| 镜像版本 | 业务镜像使用明确且可追溯的版本标签,团队能够定位对应构建 | 使用 latest 后重新拉取镜像得到不同代码 |
| 端口 | 只有需要从宿主机或外部访问的服务发布端口 | 数据库、缓存等内部服务被意外暴露 |
| Volume | 数据库、上传文件等持久化目录使用命名 Volume 或明确的宿主机路径 | 容器删除后业务数据一起消失 |
| 挂载路径 | 容器内目标路径与应用实际读写位置一致 | Volume 存在但应用把数据写到了其他目录 |
镜像版本还应与发布记录对应。出现回滚需求时,必须能够重新部署上一版本,而不是依赖某台机器上恰好缓存着旧镜像。
对于 Volume,除了确认“已挂载”,还要确认哪些数据必须持久化、谁负责备份以及容器重建后是否能重新挂载同一份数据。缓存、临时文件通常不应与核心业务数据采用相同的持久化策略。
检查环境变量与健康状态
环境变量检查的重点是值是否完整、来源是否安全、不同环境是否明确隔离。数据库密码、访问令牌等敏感信息不应直接提交到 Compose 文件或代码仓库;同时应避免生产环境意外读取开发环境的 .env 内容。
上线前至少逐项确认:
- 必填变量都有生产值,不依赖开发机上的隐式默认值。
- 数据库地址、服务 URL、域名等指向生产资源,而不是
localhost或测试环境。 - 密钥和密码通过团队约定的安全方式注入,没有进入版本控制。
- 容器需要的时区、运行模式等环境差异已经明确配置。
健康检查则回答另一个问题:容器进程还活着时,应用是否真的能够提供服务。 Web 服务的检查目标应覆盖实际可用的轻量健康端点;数据库等基础服务应使用适合自身协议的探测方式。依赖启动顺序时,也要区分“容器已经启动”和“依赖服务已经健康”。
把日志与备份纳入上线条件
日志不是发布后的附加功能。上线前应确认关键服务的标准输出和标准错误能够被持续收集,并且应用不会因为单个本地日志文件无限增长而占满宿主机磁盘。日志中还应避免打印密码、令牌和完整敏感请求数据。
备份检查则不能停留在“配置了定时任务”。对数据库或其他不可重建数据,应明确备份对象、保存位置、保留周期和恢复步骤。一次没有验证过恢复过程的备份,不能作为可靠的灾难恢复依据。
实际验收时至少需要留下最近一次成功备份的证据,并在独立环境完成恢复测试。恢复后应检查核心表、文件或业务记录是否可读取,而不是只确认恢复命令返回成功。
按固定顺序完成发布验收
多服务上线可以采用下面的顺序,避免应用启动成功后才发现基础条件缺失:
- 冻结本次发布使用的镜像版本,并确认能够回滚到上一版本。
- 验证 Compose 配置可以完整解析,检查生产环境变量是否正确注入。
- 审查发布端口,只保留真正需要对宿主机或外部开放的入口。
- 核对全部持久化 Volume、挂载路径和数据所有权。
- 启动服务后等待关键组件进入健康状态,再执行应用级访问验证。
- 检查日志是否可查询、是否存在持续报错以及磁盘增长是否受控。
- 确认最近备份有效,并保留经过验证的恢复流程与负责人信息。
上线清单的价值不在于项目里多了一份文档,而在于每一项都有明确的通过条件。只有镜像可追溯、入口受控、数据可持久化、配置无误、服务可探测、日志可追查并且备份可恢复时,这套 Compose 多服务系统才真正具备发布条件。