如何用docker run实现含depends_on配置的docker-compose效果

核心逻辑说明 #

你提供的是v2版本docker-compose配置，其中depends_on默认仅控制容器启动顺序，不会等待被依赖服务内部应用完全就绪，纯docker run实现时逻辑与该规则完全一致。

分步实现命令 #

1. 首先创建两个容器共用的自定义桥接网络，保证服务间可以通过容器名做DNS解析，复现compose默认的服务发现能力：

docker network create app-net

2. 先启动被依赖的db服务（对应compose中db配置），这一步就是复现depends_on的启动顺序要求：

docker run -d --name db --network app-net postgres

参数说明：

• -d：后台运行容器
• --name db：指定容器名为db，web服务可以直接用db作为主机名访问postgres服务
• --network app-net：将容器加入自定义网络，与后续启动的web服务连通

3. 构建web服务镜像（对应compose中build: .配置），在项目Dockerfile所在的根目录执行：

docker build -t app-web .

4. 最后启动web服务（对应compose中web配置）：

docker run -d --name web --network app-net -v $(pwd):/code -p 8000:8000 app-web python manage.py runserver 0.0.0.0:8000

参数说明：

• -v $(pwd):/code：将当前项目目录挂载到容器内/code路径，与compose卷挂载配置一致；Windows环境下请将$(pwd)替换为对应系统的当前目录路径，PowerShell中使用${PWD}，CMD中使用%cd%
• -p 8000:8000：映射宿主机8000端口到容器8000端口，与compose端口配置一致
• 末尾的命令直接覆盖镜像默认启动指令，与compose中command配置一致

depends_on对应实现的注意事项 #

• 上述严格按照「先启动db容器、再启动web容器」的顺序执行，已经100%复现了v2版本compose中默认depends_on的全部能力，原生depends_on本身不会做额外的服务可用性校验
• 如果你实际需要的是「等postgres服务完全启动、可正常接收数据库连接后再启动web服务」，compose原生的depends_on不提供这个能力，不管是compose还是纯docker run方案，都需要额外配置：
  • 可以给db容器增加健康检查规则，启动web时通过高版本docker支持的docker run --depends-on参数，指定等待db达到healthy状态后再启动web
  • 也可以在web的启动命令前增加端口探测脚本，确认db的5432端口可连通后再执行Django启动命令
• 不要使用默认bridge网络，默认网络下无法直接通过容器名解析服务地址，必须使用自定义桥接网络才能复现compose的服务发现逻辑

内容的提问来源于stack exchange，提问作者Oliver Angelil