| 用途 | 等就绪再继续 |
|---|---|
| 语法 | docker compose up -d --wait [--wait-timeout 秒] |
| 依赖 | 有 healthcheck 的服务按健康状态判定 |
示例
示例
docker compose up -d --wait --wait-timeout 120
docker compose ps --status running没有 healthcheck 的服务只按容器 running 状态判定；关键服务建议补上 healthcheck 才有就绪保证。
本包目录（366 条）
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
- docker compose up 拉起服务
- Docker Compose 概览与 v1/v2 差异
- compose 文件顶层结构
- compose ports 字段写法
- docker compose logs 聚合日志
- services 定义与容器命名规则
- compose environment 字段两种形式
- docker compose ps 查看服务状态
- compose volumes 字段写法
- compose depends_on 启动依赖
- docker compose down 停止并清理
- image 与 build 字段的配合
- compose restart 策略字段
- docker compose exec 进入服务容器
- docker compose config 校验与展开
- compose healthcheck 字段
- docker compose run 一次性任务
- compose networks 字段与网络别名
- compose 顶层 volumes 与驱动配置
- 项目级 .env 文件与变量来源优先级
- compose 资源限制字段
- docker compose build 构建服务镜像
- compose 多文件合并与 override 约定
- compose start/stop/restart/pause 语义
- compose env_file 字段
- compose command 与 entrypoint 覆盖
- compose logging 日志驱动与截断
- docker compose up --wait 等待健康
- compose 变量插值语法与转义
- compose 文件的 version 字段已废弃
- docker compose pull / push 镜像流转
- compose 扩容 --scale 与副本数
- compose 项目名与资源命名
- docker-compose v1 到 compose v2 对照
- compose profiles 分组启动
- compose labels 与自动标签
- compose 默认文件名与查找顺序
- compose container_name 固定容器名
- docker compose ls 列出项目
- compose 停服信号与宽限期
- compose secrets 注入敏感文件
- compose 项目资源清理核对
- docker compose port 查询端口映射
- docker compose images 列出服务镜像
- compose shm_size 调整共享内存
- compose extra_hosts 注入 hosts 记录
- compose 网络的 internal 与 external
- docker compose cp 与容器互拷文件
- docker compose watch 开发热更新
- compose init 字段启用 init 进程
- compose ulimits 调整进程资源限制
- compose configs 挂载配置文件
- compose config --hash 检测配置变化
- compose include 复用其他文件
- docker compose top 查看服务进程
docker compose up --wait 等待健康
up 加 --wait 会等到所有服务达到 running/healthy 才返回：适合 CI 与发布脚本，避免服务没就绪就开始后续步骤。
易错点
- 服务健康检查写得太宽松（interval 大、retries 多）会把等待时间拖得很长，超时参数要匹配
- 等待中的失败会以非零退出码结束，脚本里要把它当发布失败处理而不是忽略
数据来源与参考
- Docker 官方 CLI 参考：docker compose up 的 --wait（docs.docker.com）