用途:在 docker compose up 失败、服务拒绝启动或依赖健康检查超时时,提供系统化的 Compose 排错流程,防止未校验的 Compose 文件引发级联故障。
主要能力:强调先运行 docker compose config 校验并渲染最终配置,可用 docker compose config -q 仅看退出码、docker compose config --environment 查看解析后的环境变量。提供诊断决策树,覆盖文件无法解析、服务无法启动、孤儿容器警告等场景,并给出错误信息到原因与修复的对照表,如端口占用、依赖失败、构建失败、镜像拉取失败、卷挂载错误、变量未设置等。
必要用法:校验命令 docker compose config;启动 docker compose up --build --force-recreate -d;查看状态 docker compose ps;查看日志 docker compose logs --tail 50 <service-name>;清理孤儿容器 docker compose down --remove-orphans。依赖数据库等需初始化时间的服务时,应使用 depends_on 配合 condition: service_healthy,并配置 healthcheck 的 interval、timeout、retries、start_period。端口映射建议加引号,如 "8080:80"。
适用场景:本地开发与 CI 中调试 Compose 编排问题,处理端口冲突、依赖顺序、健康检查、卷与网络声明、环境变量插值、profile 依赖等。
限制:资料未提供该技能的安装方式、收费、平台支持或效果数据;内容以 Docker Compose 官方文档为参考,具体行为以实际环境为准。