Docker Compose 生成器

现代 Compose 规范

Compose V2（随 Docker Desktop 和现代 Docker Engine 提供的插件）遵循 Compose 规范。version: 键已被弃用，生成器会省略它。顶层键为 services、networks、volumes、configs 和 secrets。

服务结构

一个接近生产环境的服务长这样：

services:
  web:
    image: nginx:1.27-alpine
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./public:/usr/share/nginx/html:ro
    depends_on:
      app:
        condition: service_healthy
    networks:
      - frontend
      - backend
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost/health"]
      interval: 30s
      timeout: 5s
      retries: 3

卷：绑定挂载与命名卷

• 绑定挂载（./app:/var/www）把容器绑定到宿主机上的路径，本地开发非常方便，因为改动会立即生效。
• 命名卷（pgdata:/var/lib/postgresql/data）由 Docker 管理，独立于任何宿主机路径，适合数据库以及任何你不希望被 rm -rf 误删的内容。
• 匿名卷 - 应避免。它能撑过重启，但执行 docker compose down -v 时会毫无提示地消失。

网络

默认情况下 Compose 会创建一个以项目命名的网络，并把每个服务连接上去。在以下情况显式声明网络很有用：

• 你想把数据库与面向公网的服务隔离。
• 你需要带自定义子网的 bridge，以对接现有基础设施。
• 你想把容器接入已存在的外部网络（external: true）。

应避免的常见错误

• version 键冲突。 顶部的 version: "3.8" 会让 healthcheck 的 start_interval 等新功能在旧版 Compose 上失效；生成器会省略 version 键。
• 端口引号。 8080:80 在某些边界情况下会被解析为 YAML 的 60 进制数；生成器始终为端口映射加引号。
• 硬编码的密钥。 直接写进 compose.yml 的密钥最终会被提交到 git。请把它们放在 env_file 或平台的密钥存储中。
• 没有条件的 depends_on。 简单的 depends_on: [db] 只等容器启动，不等服务就绪。请使用 condition: service_healthy 并为依赖项添加健康检查。