docker-compose

Docker Compose 多容器编排

补充说明

docker compose（v2 插件，旧命令是 docker-compose）按 compose.yaml 启动多容器应用，适合本地开发和单机部署。它管理容器、网络和卷，但不负责多节点调度。

常用示例

docker compose up -d
docker compose up -d --build
docker compose ps
docker compose logs -f web
docker compose exec web sh
docker compose run --rm web npm test
docker compose build
docker compose pull
docker compose restart web
docker compose config
docker compose up --scale web=3 -d
docker compose -f compose.prod.yaml up -d
docker compose --env-file .env.prod up -d
docker compose --profile debug up -d
docker compose down
docker compose down -v

易错点与排错

• 先确认是 v2 插件 docker compose 还是旧的 docker-compose；两者参数有差异。
• 项目名默认取目录名；不同目录的同名服务会属于不同项目。
• down -v 会删除命名卷和其中的数据；执行前确认备份。
• 环境变量优先级是 shell > .env > compose 文件默认值；排查时用 config 看最终值。
• depends_on 只保证启动顺序，不保证服务就绪；需要健康检查或重试逻辑。
• build 的上下文和 Dockerfile 路径相对 compose 文件；路径写错会构建失败。
• 镜像标签用 latest 会导致环境漂移；生产环境固定版本或 digest。
• profile 未激活时服务不会启动；--profile 要写全。
• 容器内 localhost 指向容器自己；访问宿主机服务要用 host.docker.internal 或网络别名。

相关命令

• docker-buildx — 多平台镜像构建
• docker — 单容器操作
• podman — 无守护进程替代

读完自测

合上页面，先回答，再展开对照。

1. 怀疑环境变量没有按预期生效时，用什么命令查看最终值？优先级是什么？
2. depends_on 能保证依赖服务已经就绪吗？如果不能，应该补充什么？
3. 执行 docker compose down -v 前必须确认什么？