GoCD 构建专用 Docker 镜像文档

一、镜像概述与主要用途

本系列镜像为 GoCD 项目专用的构建环境镜像，主要用于 GoCD 自身的构建流程。镜像基于不同操作系统环境构建，集成了 GoCD 构建所需的依赖工具与环境配置，确保构建过程的一致性与可重复性。

二、核心功能与特性

1. 多平台构建支持

提供基于多种操作系统环境的构建镜像，满足不同构建场景需求：

• Linux 环境：CentOS 8、Ubuntu 20.04
• Windows 环境：Windows Server 2019
• Docker-in-Docker (DinD)：支持在容器内运行 Docker 服务，满足嵌套构建需求

2. 构建依赖集成

预集成 GoCD 构建过程中所需的编译工具、依赖库及环境配置，无需额外手动安装依赖。

3. 版本化标签管理

镜像标签采用 <基础系统>-<github_tag> 格式（如 ubuntu-20-04-v23.3.0），github_tag 对应 GoCD 项目的 GitHub 版本标签，便于版本追溯与构建一致性控制。

三、使用场景与适用范围

1. GoCD 项目构建

• GoCD 开发团队本地构建与调试
• CI/CD 流水线中自动化构建任务（如官方构建系统 [***]

2. 多平台兼容性验证

在不同操作系统环境下验证 GoCD 构建产物的兼容性。

3. 构建环境标准化

统一开发与 CI 环境，避免"本地可构建，CI 失败"的环境差异问题。

四、使用方法与配置说明

1. 镜像拉取

通过 Docker 命令拉取指定版本的镜像：

# 拉取 Ubuntu 20.04 版本（示例标签）
docker pull gocddev/gocd-dev-build:ubuntu-20-04-v23.3.0

# 拉取 CentOS 8 版本（示例标签）
docker pull gocddev/gocd-dev-build:centos-8-v23.3.0

# 拉取 DinD 版本（示例标签）
docker pull gocddev/gocd-dev-build:dind-v23.3.0

# Windows 镜像（PowerShell 中执行，示例标签）
docker pull gocddev/gocd-dev-build:windows2019-v23.3.0

2. 容器运行示例

Linux 环境镜像（Ubuntu/CentOS）

# 运行 Ubuntu 20.04 构建容器，挂载本地源码目录并执行构建命令
docker run -it --rm \
  -v /path/to/gocd/source:/workspace \
  gocddev/gocd-dev-build:ubuntu-20-04-v23.3.0 \
  /bin/bash -c "cd /workspace && ./gradlew build"

Docker-in-Docker (DinD) 镜像

需添加 --privileged 权限以支持容器内 Docker 服务：

docker run -it --rm --privileged \
  -v /path/to/gocd/source:/workspace \
  gocddev/gocd-dev-build:dind-v23.3.0 \
  /bin/bash -c "service docker start && cd /workspace && ./build.sh"

Windows 环境镜像

在 Windows 容器模式下运行（需 Windows 主机或支持 Windows 容器的 Docker 环境）：

docker run -it --rm `
  -v C:\path\to\gocd\source:C:\workspace `
  gocddev/gocd-dev-build:windows2019-v23.3.0 `
  powershell -Command "cd C:\workspace; .\build.ps1"

3. Docker Compose 配置示例（Linux 环境）

version: '3'
services:
  gocd-build:
    image: gocddev/gocd-dev-build:ubuntu-20-04-v23.3.0
    volumes:
      - ./gocd-source:/workspace
    command: ["/bin/bash", "-c", "cd /workspace && ./gradlew clean build"]

4. 配置参数说明

具体构建配置参数（如环境变量、构建工具选项等）需根据 GoCD 构建脚本要求调整，详细信息请参考：
GoCD 官方构建文档

五、镜像标签说明

六、参考链接

• GoCD 官方构建系统
• GoCD GitHub 项目