docker-compose 多容器编排

摘要：单机上要跑多个互相依赖的容器时，手写一堆 docker run 不可维护。本文用一份 compose 文件定义 Web + MySQL + Redis，覆盖启动顺序、健康检查、数据卷、网络与常用运维命令。

适用环境

• 已安装 Docker（含 docker compose 插件，注意是空格不是横线）
• 内存 ≥ 4G
• 示例镜像：nginx:alpine、mysql:8、redis:7-alpine

操作步骤

一、确认插件可用

docker compose version

若提示命令不存在，回到官方安装文档补装 docker-compose-plugin。

二、编写 compose.yaml

services:
  web:
    image: nginx:1.27-alpine
    ports:
      - "8080:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
    depends_on:
      db:
        condition: service_healthy
    networks:
      - app-net
    restart: unless-stopped

  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: ExamplePass123
      MYSQL_DATABASE: appdb
    volumes:
      - db-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - app-net
    restart: unless-stopped

  cache:
    image: redis:7-alpine
    command: ["redis-server", "--appendonly", "yes"]
    volumes:
      - cache-data:/data
    networks:
      - app-net
    restart: unless-stopped

volumes:
  db-data:
  cache-data:

networks:
  app-net:
    driver: bridge

关键设计：

1. depends_on 的 condition: service_healthy 让 web 等数据库真正就绪再启动，而不是等它「容器起来了」。
2. 数据卷用命名卷，不绑宿主路径，方便迁移。
3. 三个服务在同一 app-net，可直接用服务名互访：db:3306、cache:6379。

三、用 .env 管理变量

cat > .env <<'EOF'
MYSQL_ROOT_PASSWORD=ExamplePass123
WEB_PORT=8080
EOF

services:
  web:
    ports:
      - "${WEB_PORT}:80"
  db:
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}

四、启动与管理

docker compose up -d                 # 后台启动全部服务
docker compose ps                    # 查看状态
docker compose logs -f web           # 只看 web 的日志
docker compose logs -f --tail=100    # 全部服务最后 100 行
docker compose exec db sh            # 进容器
docker compose up -d --scale web=3   # 扩容 web 到 3 个
docker compose stop                  # 停止但保留容器
docker compose down                  # 停止并移除容器、网络
docker compose down -v               # 连数据卷一起删

危险

docker compose down -v 会永久删除 compose 文件里声明的所有命名卷，数据库数据不可恢复。生产环境执行前必须先备份。

五、修改配置后的生效方式

docker compose up -d          # 只重建有变化的服务
docker compose restart web    # 仅重启，不重建（配置变更时不够）

改了 environment 或挂载文件必须 up -d 重建，restart 不会重新注入环境变量。

验证

• [ ] docker compose ps 三个服务均为 running（db 还需 healthy）
• [ ] curl http://127.0.0.1:8080 可访问
• [ ] docker compose exec web ping -c 2 db 能解析并通
• [ ] 写入数据库后 down 再 up -d，数据仍在

常见坑

• web 先于 db 起来导致连不上：depends_on 默认只等容器启动不等就绪，必须配 condition: service_healthy。
• 端口冲突 address already in use：宿主 8080 被占用，改 .env 里的 WEB_PORT 或停掉占用进程。
• 改了 compose 文件没生效：只执行了 restart，需要用 up -d 触发重建。
• docker-compose（带横线）命令找不到：新版是插件形式 docker compose（空格），旧式 Python 版已弃用。
• 数据莫名丢失：误用了 down -v，或把 volume 定义写成了 ./data:/var/lib/mysql 后清空了宿主目录。

参考资料

• Docker Compose 官方文档
• compose 文件参考
• docker compose CLI 参考
• Compose 中的环境变量