docker-compose（Docker Compose 编排）

When to use this skill

Use this skill whenever the user wants to:

• 用 docker-compose 定义多服务栈（services、networks、volumes）
• 本地或单机运行多容器（app、DB、缓存、队列）
• 管理环境变量、依赖顺序与健康检查

How to use this skill

1. 配置：docker-compose.yml 定义 services、image/build、ports、volumes、environment、depends_on；用 profiles 做可选服务。
2. CLI：docker compose up -d、down、logs -f、ps；override 用 -f 或 docker-compose.override.yml。
3. 环境：.env 或 env_file 注入变量；secrets 用 Docker secrets 或外部方案。

Example: docker-compose.yml with health check

services:
  app:
    build: .
    ports:
      - "3000:3000"
    depends_on:
      db:
        condition: service_healthy
    environment:
      DATABASE_URL: postgres://user:pass@db:5432/mydb

  db:
    image: postgres:16
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user"]
      interval: 10s
      timeout: 5s
      retries: 3

volumes:
  pgdata:

Best Practices

• 服务间用内部网络；仅暴露必要端口。
• 数据卷命名或使用命名卷；避免依赖默认匿名卷路径。
• 生产多节点用 Kubernetes 或 Swarm；compose 适合开发与单机部署。

Keywords

docker compose, docker-compose.yml, multi-container, 多容器, 编排