开始之前

Compose 文件通过 YAML 解析,仍可能因为服务、网络或卷引用缺失而失败。可靠预检应先做本地静态检查,再使用生产部署实际采用的 Compose 引擎和环境完成权威验证。

边看边操作在 Compose 校验 中打开实际工作区
01

先做私密静态检查

不拉取镜像,先检查服务、引用、标签、端口、权限和明文敏感值。

示例
compose.yaml
02

核对环境变量

列出每个 ${VARIABLE},确认部署环境可以注入,同时避免把 Secret 提交到代码库。

示例
${DATABASE_URL}
03

使用目标 Compose 解析器

使用与生产环境相同的 Docker Compose 主版本校验配置。

示例
docker compose config --quiet
04

检查渲染后的项目

在非生产环境复查标准化配置、镜像拉取、健康检查、资源限制和启动依赖。

示例
docker compose config
要点总结
  • 有效 YAML 不等于有效 Compose 配置。
  • 静态检查不会拉取镜像,也不能证明运行健康。
  • 最终结果以目标 Docker Compose 引擎为准。