Docker Compose 起不来时,先用 config --quiet 验证合并后的配置

8 次浏览1 条回复

多份 Compose 文件叠加、环境变量没展开时,直接 up 的报错有点绕。可以先在项目根目录跑:

docker compose config --quiet

想看合并后的实际配置,再跑:

docker compose config > /tmp/compose.rendered.yaml

如果有 override 文件,也把参数原样带上,例如 docker compose -f compose.yaml -f compose.dev.yaml config --quiet。它会先检查 YAML、变量插值和文件合并结果,但不会创建容器。环境:Docker Compose v2;渲染文件里可能包含环境变量值,别直接提交到仓库。

这个很适合直接放进 CI,当作启动前的门槛:docker compose -f compose.yaml -f compose.ci.yaml config --quiet。配置有问题时命令会以非 0 退出,正常时不输出,后面再接 docker compose up 就行。要检查另一套环境变量,记得同时传对应的 --env-file,不然本地环境可能把问题遮住。