4. Docker Compose 编排：docker-compose.yml 编写、多服务部署与环境变量管理

在授权测试与数据传输优化的实际场景中，单一容器往往无法满足完整的测试链路需求。例如，一个典型的授权测试环境需要同时运行 授权服务、测试客户端、数据存储 以及 网络代理 等多个组件。Docker Compose 通过声明式的 docker-compose.yml 文件，允许你一键定义、启动和编排这些相互依赖的服务，从而构建可复现、可隔离的测试环境。

4.1 docker-compose.yml 核心结构

一个标准的 docker-compose.yml 文件遵循 YAML 语法，主要包含 version、services、networks 和 volumes 四个顶级字段。以下是一个针对授权测试场景的基础模板：

version: '3.8'

services:
  # 授权服务：模拟 OAuth2 授权服务器
  auth-server:
    image: your-registry/auth-server:latest
    container_name: auth-server
    ports:
      - "9000:9000"
    environment:
      - DB_HOST=postgres-db
      - DB_PORT=5432
      - AUTH_JWT_SECRET=${JWT_SECRET}
    depends_on:
      postgres-db:
        condition: service_healthy
    networks:
      - test-net
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9000/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  # 测试客户端：发起授权请求并验证响应
  test-client:
    image: your-registry/test-client:latest
    container_name: test-client
    environment:
      - AUTH_ENDPOINT=http://auth-server:9000
      - TEST_SCENARIO=${TEST_SCENARIO:-basic}
    depends_on:
      auth-server:
        condition: service_started
    networks:
      - test-net
    command: ["python", "run_tests.py"]

  # 数据库：存储授权令牌与审计日志
  postgres-db:
    image: postgres:15-alpine
    container_name: postgres-db
    environment:
      POSTGRES_USER: test_user
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: auth_test_db
    volumes:
      - pgdata:/var/lib/postgresql/data
      - ./init-scripts:/docker-entrypoint-initdb.d
    networks:
      - test-net
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U test_user -d auth_test_db"]
      interval: 10s
      timeout: 5s
      retries: 5

networks:
  test-net:
    driver: bridge

volumes:
  pgdata:
    driver: local

4.2 多服务部署与网络拓扑

在授权测试中，服务间的网络拓扑直接影响测试的隔离性与安全性。下图展示了使用 Docker Compose 编排的典型授权测试环境网络架构：

4.3 环境变量管理策略

在授权测试中，环境变量用于管理敏感信息（如 JWT 密钥、数据库密码）和测试配置（如测试场景、端点地址）。Docker Compose 提供多种方式注入环境变量，以下表格对比了常用方法：

4.4 环境变量作用域与优先级

当多种环境变量注入方式同时存在时，Docker Compose 遵循明确的优先级规则。理解这一规则有助于避免配置冲突：

4.5 实际授权测试场景的 Compose 配置示例

以下是一个完整的 docker-compose.yml 示例，集成了环境变量管理与多服务编排，适用于 OAuth2 授权码模式 的自动化测试：

version: '3.8'

services:
  # 授权服务器（模拟 Keycloak / 自定义 OAuth2 服务）
  auth-server:
    image: quay.io/keycloak/keycloak:22.0.1
    container_name: auth-server
    environment:
      KC_HOSTNAME: auth-server
      KC_HTTP_PORT: 9000
      KC_DB_URL_HOST: postgres-db
      KC_DB_URL_DATABASE: auth_test_db
      KC_DB_USERNAME: test_user
      KC_DB_PASSWORD: ${DB_PASSWORD}
      KEYCLOAK_ADMIN: admin
      KEYCLOAK_ADMIN_PASSWORD: ${ADMIN_PASSWORD}
    ports:
      - "9000:9000"
    depends_on:
      postgres-db:
        condition: service_healthy
    networks:
      - test-net
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9000/health/ready"]
      interval: 30s
      timeout: 10s
      retries: 5

  # 测试客户端（使用 Python + requests 库执行授权流程）
  test-client:
    build:
      context: ./test-client
      dockerfile: Dockerfile
    container_name: test-client
    environment:
      AUTH_SERVER_URL: http://auth-server:9000
      CLIENT_ID: ${TEST_CLIENT_ID}
      CLIENT_SECRET: ${TEST_CLIENT_SECRET}
      REDIRECT_URI: http://localhost:8080/callback
      TEST_SCOPE: "openid profile email"
    depends_on:
      auth-server:
        condition: service_healthy
    networks:
      - test-net
    volumes:
      - ./test-results:/app/results
    command: ["pytest", "tests/", "--junitxml=/app/results/report.xml"]

  # 数据库
  postgres-db:
    image: postgres:15-alpine
    container_name: postgres-db
    environment:
      POSTGRES_USER: test_user
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: auth_test_db
    volumes:
      - pgdata:/var/lib/postgresql/data
    networks:
      - test-net
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U test_user -d auth_test_db"]
      interval: 10s
      timeout: 5s
      retries: 5

networks:
  test-net:
    driver: bridge

volumes:
  pgdata:
    driver: local

4.6 常见问题与避坑指南