Concourse Dev Image 技术文档

1. 镜像概述和主要用途

Concourse Dev Image 是基于 Concourse 主开发流水线生成的类发布候选版（RC-like）镜像，构建素材来源于 GitHub master 分支的最新代码。该镜像旨在提供 Concourse 最新开发阶段的功能预览，供用户测试未正式发布的特性和改进。

2. 核心功能和特性

• 最新开发特性：包含 Concourse master 分支的最新代码变更，提供未正式发布的功能和修复。
• 持续构建更新：通过 Concourse 主开发流水线（[***] master 分支代码同步。
• 类 RC 特性：镜像稳定性介于开发快照与正式发布版之间，具备基础功能验证，但未经过完整的生产环境测试。

3. 使用场景和适用范围

适用场景

• 开发测试环境：供开发者验证最新功能实现，或复现/修复开发阶段的问题。
• 特性预览：用户可提前评估即将发布的功能，为生产环境升级做准备。
• 社区贡献验证：Concourse 贡献者测试代码提交后的功能表现。

适用范围

• 环境限制：仅适用于开发、测试环境，禁止用于生产环境（稳定性和兼容性未经过生产级验证）。
• 用户群体：Concourse 开发者、需要提前验证新特性的技术团队、CI/CD 工具测试人员。

4. 详细使用方法和配置说明

4.1 前置依赖

• Docker 环境（推荐 20.10+ 版本）。
• 外部数据库（如 PostgreSQL 13+，Concourse 元数据存储依赖）。
• 持久化存储（用于保存流水线配置、任务日志等数据）。

4.2 基本运行命令（单机模式示例）

以下命令启动 Concourse Web 节点（管理界面和 API）和 Worker 节点（任务执行），使用内置的 "dummy" 认证（仅用于测试）：

# 启动 Concourse Web 节点（需提前准备 PostgreSQL 实例）
docker run -d \
  --name concourse-web \
  -p 8080:8080 \
  -e CONCOURSE_EXTERNAL_URL=http://localhost:8080 \
  -e CONCOURSE_POSTGRES_HOST=<postgres-host> \
  -e CONCOURSE_POSTGRES_USER=<postgres-user> \
  -e CONCOURSE_POSTGRES_PASSWORD=<postgres-password> \
  -e CONCOURSE_POSTGRES_DATABASE=<postgres-db> \
  -e CONCOURSE_ADD_LOCAL_USER=test:test \  # 本地测试用户（用户名:密码）
  concourse/dev:latest web

# 启动 Concourse Worker 节点（连接到 Web 节点）
docker run -d \
  --name concourse-worker \
  --privileged \  # Worker 需要特权模式以运行容器任务
  -e CONCOURSE_TSA_HOST=localhost:2222 \  # Web 节点的 TSA 服务地址
  -e CONCOURSE_TSA_PUBLIC_KEY=/keys/tsa_host_key.pub \
  -e CONCOURSE_WORKER_PRIVATE_KEY=/keys/worker_key \
  -v $(pwd)/keys:/keys \  # 挂载密钥目录（需提前生成）
  concourse/dev:latest worker

4.3 关键配置参数

4.3.1 环境变量（Web 节点）

4.3.2 密钥文件（Worker 节点）

Worker 需通过密钥与 Web 节点的 TSA 服务通信，需提前生成密钥对：

mkdir -p keys
ssh-keygen -t rsa -f keys/tsa_host_key -N ''  # TSA 主机密钥
ssh-keygen -t rsa -f keys/worker_key -N ''    # Worker 私有密钥
cp keys/tsa_host_key.pub keys/authorized_worker_keys  # 授权 Worker 公钥

4.4 Docker Compose 示例（含 PostgreSQL）

快速部署完整测试环境（Web + Worker + PostgreSQL）：

version: '3'

services:
  postgres:
    image: postgres:13
    environment:
      POSTGRES_USER: concourse
      POSTGRES_PASSWORD: concourse
      POSTGRES_DB: concourse
    volumes:
      - postgres-data:/var/lib/postgresql/data

  web:
    image: concourse/dev:latest
    command: web
    depends_on:
      - postgres
    ports:
      - "8080:8080"  # Web 界面
      - "2222:2222"  # TSA 服务（Worker 连接端口）
    environment:
      CONCOURSE_EXTERNAL_URL: http://localhost:8080
      CONCOURSE_POSTGRES_HOST: postgres
      CONCOURSE_POSTGRES_USER: concourse
      CONCOURSE_POSTGRES_PASSWORD: concourse
      CONCOURSE_POSTGRES_DATABASE: concourse
      CONCOURSE_ADD_LOCAL_USER: test:test
    volumes:
      - ./keys:/keys

  worker:
    image: concourse/dev:latest
    command: worker
    depends_on:
      - web
    privileged: true
    environment:
      CONCOURSE_TSA_HOST: web:2222
      CONCOURSE_TSA_PUBLIC_KEY: /keys/tsa_host_key.pub
      CONCOURSE_WORKER_PRIVATE_KEY: /keys/worker_key
    volumes:
      - ./keys:/keys

volumes:
  postgres-data:

4.5 使用注意事项

1. 生产环境禁用：该镜像为开发版本，稳定性和兼容性未经过生产验证，请勿用于生产环境。
2. 数据持久化：通过挂载卷（如 postgres-data）确保数据库和任务数据不丢失。
3. 网络配置：若部署在跨主机环境，需确保 Web 节点的 CONCOURSE_EXTERNAL_URL 和 TSA 端口可被 Worker 访问。
4. 版本兼容性：master 分支代码可能包含破坏性变更，建议定期同步最新镜像以避免兼容性问题。

5. 镜像获取

通过 Docker Hub 拉取最新版本：

docker pull concourse/dev:latest

（注：镜像标签 latest 对应 master 分支最新构建，历史版本需指定具体 commit 标签，如 concourse/dev:abc123）