容器与云原生 / 知识点
Docker Compose 命令速查手册
CI、脚本与自动化
docker compose up -d --wait --wait-timeout <SEC>把服务启动健康状态作为部署命令成功条件。
CI 部署等待健康
把服务启动健康状态作为部署命令成功条件。
基本语法
docker compose up -d --wait --wait-timeout <SEC>推荐用法
docker compose up -d --wait --wait-timeout 120预期结果
全部达到 running/healthy 后返回 0,否则失败。关键边界
推荐把关键服务 healthcheck 写完整,否则只能确认进程在运行。
docker compose exec -T <SERVICE> <COMMAND>避免 CI 因默认 TTY 分配出现输入/输出问题。
CI 执行容器内命令
避免 CI 因默认 TTY 分配出现输入/输出问题。
基本语法
docker compose exec -T <SERVICE> <COMMAND>推荐用法
docker compose exec -T web ./bin/test预期结果
命令非交互执行并返回退出码。关键边界
需要交互输入的命令不适合这样跑。
docker compose run --rm -T <SERVICE> <COMMAND>创建隔离 one-off container 执行测试并自动删除。
CI 运行一次性测试容器
创建隔离 one-off container 执行测试并自动删除。
基本语法
docker compose run --rm -T <SERVICE> <COMMAND>推荐用法
docker compose run --rm -T web ./bin/test预期结果
测试退出码传递给 CI。关键边界
与 exec 相比,不污染运行中容器的进程空间。
开发模式与 Compose Watch
docker compose watch [SERVICE...]根据 develop.watch 规则监听源码变化并同步/重建服务。
启动 Compose Watch
根据 develop.watch 规则监听源码变化并同步/重建服务。
基本语法
docker compose watch [SERVICE...]推荐用法
docker compose watch web预期结果
文件变化后触发 sync、restart 或 rebuild。关键边界
Compose Watch 需要在 Compose 文件配置 watch 规则;适合本地开发。
docker compose up --watch启动项目并进入 Compose Watch。
Up 时同时启用 Watch
启动项目并进入 Compose Watch。
基本语法
docker compose up --watch推荐用法
docker compose up --watch预期结果
服务启动,随后监听文件变化。关键边界
会同时混合应用日志和 watch 事件;想分开输出可用独立 docker compose watch。
高频区别与故障排查
docker compose up -d vs docker compose startup 会创建/必要时重建;start 只启动已有容器。
区分 up 与 start
up 会创建/必要时重建;start 只启动已有容器。
基本语法
docker compose up -d vs docker compose start推荐用法
docker compose up -d预期结果
`up -d` 会让运行状态与当前 Compose 配置更一致。关键边界
修改 compose.yaml 后不要只执行 start。
docker compose exec ... vs docker compose run ...exec 在已有运行容器中启动进程;run 创建新的 one-off 容器。
区分 exec 与 run
exec 在已有运行容器中启动进程;run 创建新的 one-off 容器。
基本语法
docker compose exec ... vs docker compose run ...推荐用法
docker compose exec web sh预期结果
exec 共享当前容器状态;run 使用新的容器实例。关键边界
线上排障进入现有实例用 exec;迁移/测试/管理任务常用 run --rm。
docker compose stop vs docker compose downstop 保留容器与网络资源;down 会删除容器和项目网络。
区分 stop 与 down
stop 保留容器与网络资源;down 会删除容器和项目网络。
基本语法
docker compose stop vs docker compose down推荐用法
docker compose stop预期结果
stop 后可 start;down 后通常需要 up 重建。关键边界
想临时停机用 stop;想拆除项目用 down。
docker compose up -drestart 不会把新的 Compose 配置应用到现有容器。
配置变更后不要只 restart
restart 不会把新的 Compose 配置应用到现有容器。
基本语法
docker compose up -d推荐用法
docker compose up -d预期结果
`up -d` 检测配置/镜像变化并按需要重建。关键边界
修改 environment、ports、volumes 等后,优先 up -d。
docker compose config检查 .env、Shell 环境、--env-file 等最终如何插值。
排查变量替换结果
检查 .env、Shell 环境、--env-file 等最终如何插值。
基本语法
docker compose config推荐用法
docker compose config预期结果
输出最终解析后的值。关键边界
变量问题不要只看源文件;先比较 config 与 config --environment。
docker compose ps -a && docker compose logs --tail 200 <SERVICE>先确认 Exit 状态,再读取最近日志。
排查服务启动后立即退出
先确认 Exit 状态,再读取最近日志。
基本语法
docker compose ps -a && docker compose logs --tail 200 <SERVICE>推荐用法
docker compose ps -a && docker compose logs --tail 200 web预期结果
输出容器状态和退出前日志。关键边界
容器主进程退出,容器就会退出;不要先怀疑 Docker 网络。
docker compose ps && docker compose logs <SERVICE>查看服务是否 running 但 unhealthy,并检查应用日志。
排查健康检查失败
查看服务是否 running 但 unhealthy,并检查应用日志。
基本语法
docker compose ps && docker compose logs <SERVICE>推荐用法
docker compose ps && docker compose logs --tail 200 web预期结果
ps 显示 health 状态,logs 提供应用线索。关键边界
healthcheck 命令本身也可能配置错误,需要结合容器 inspect 深入排查。
docker compose ps && docker compose port <SERVICE> <PORT>确认 Compose 是否实际发布目标端口以及宿主端口是多少。
排查端口映射
确认 Compose 是否实际发布目标端口以及宿主端口是多少。
基本语法
docker compose ps && docker compose port <SERVICE> <PORT>推荐用法
docker compose ps && docker compose port web 8080预期结果
输出服务状态和 host binding。关键边界
容器内监听 127.0.0.1 也可能导致外部无法访问。
docker compose ls && docker compose -p <PROJECT> ps发现同一目录产生多套资源时检查 project name。
排查 Compose 项目名不一致
发现同一目录产生多套资源时检查 project name。
基本语法
docker compose ls && docker compose -p <PROJECT> ps推荐用法
docker compose ls预期结果
显示当前 Engine 上 Compose projects。关键边界
-p、COMPOSE_PROJECT_NAME、top-level name、目录名都可能影响 project name。
docker compose -f <BASE> -f <OVERRIDE> config确认 override 后的最终字段、路径和服务。
排查多文件合并错误
确认 override 后的最终字段、路径和服务。
基本语法
docker compose -f <BASE> -f <OVERRIDE> config推荐用法
docker compose -f compose.yaml -f compose.prod.yaml config预期结果
输出完整合并模型。关键边界
多文件路径和列表/映射合并规则不要靠直觉猜。
docker compose ps --orphans查看当前项目中不再被 Compose 文件声明的容器。
排查 orphan 容器
查看当前项目中不再被 Compose 文件声明的容器。
基本语法
docker compose ps --orphans推荐用法
docker compose ps --orphans预期结果
orphan service 仍会出现在输出中。关键边界
确认无用后再使用 --remove-orphans。
docker compose pull && docker compose up -d先明确拉取目标镜像,再让 Compose 根据镜像变化重建服务。
排查镜像未更新
先明确拉取目标镜像,再让 Compose 根据镜像变化重建服务。
基本语法
docker compose pull && docker compose up -d推荐用法
docker compose pull web && docker compose up -d web预期结果
新镜像拉取并用于服务容器。关键边界
如果镜像 tag 不可变性很重要,使用版本 tag 或 digest。