travix/gocd-agent

travix/gocd-agent

Go.CD 持续交付代理，内置Docker in Docker功能。

镜像概述和主要用途

travix/gocd-agent是一个预配置的Go.CD持续交付代理镜像，内置Docker in Docker功能，用于连接Go.CD服务器并执行持续集成/持续交付(CI/CD)任务。该镜像简化了代理的部署和配置过程，支持通过环境变量自定义服务器连接、资源标签、环境分配等参数，并可通过卷挂载实现数据持久化和SSH密钥管理。

核心功能和特性

• 内置Docker in Docker：支持在代理中直接运行Docker命令，满足容器化构建和部署需求
• 灵活配置：通过环境变量自定义服务器连接信息、JVM内存参数、资源标签和环境分配
• 数据持久化：支持挂载卷以保存工作副本、日志和SSH密钥
• 自动注册：通过AGENT_KEY环境变量实现与Go.CD服务器的自动注册

使用场景和适用范围

适用于需要构建Go.CD持续交付流水线的团队，尤其适合以下场景：

• 构建和部署容器化应用
• 需要在CI/CD流程中使用Docker命令的场景
• 需为不同环境（如开发、测试、生产）分配专用代理的场景
• 需要持久化构建数据或管理版本控制系统SSH密钥的场景

使用方法和配置说明

基本使用

运行以下命令启动Go.CD代理容器：

sh
docker run -d travix/gocd-agent:latest

环境变量配置

通过以下环境变量可自定义代理配置：

配置示例

连接自定义服务器：

sh
docker run -d \
    -e "GO_SERVER=gocd.yourdomain.com" \
    travix/gocd-agent:latest

使用自动注册密钥：

sh
docker run -d \
    -e "GO_SERVER=gocd.yourdomain.com" \
    -e "AGENT_KEY=388b633a88de126531afa41eff9aa69e" \
    travix/gocd-agent:latest

完整配置（资源标签、环境和主机名）：

sh
docker run -d \
    -e "GO_SERVER=gocd.yourdomain.com" \
    -e "AGENT_KEY=388b633a88de126531afa41eff9aa69e" \
    -e "AGENT_RESOURCES=deploy-x,deploy-z" \
    -e "AGENT_ENVIRONMENTS=Production" \
    -e "AGENT_HOSTNAME=deploy-agent-01" \
    travix/gocd-agent:latest

卷挂载

可挂载以下目录以实现数据持久化和密钥管理：

挂载示例

sh
docker run -d \
    -e "GO_SERVER=gocd.yourdomain.com" \
    -e "AGENT_KEY=388b633a88de126531afa41eff9aa69e" \
    -e "AGENT_RESOURCES=deploy-x,deploy-z" \
    -e "AGENT_ENVIRONMENTS=Production" \
    -e "AGENT_HOSTNAME=deploy-agent-01" \
    -v /mnt/persistent-disk/gocd-agent/pipelines:/var/lib/go-agent/pipelines \
    -v /mnt/persistent-disk/gocd-agent/logs:/var/log/go-agent \
    -v /mnt/persistent-disk/gocd-agent/ssh:/var/go/.ssh \
    travix/gocd-agent:latest

权限配置

为确保容器内进程可读写挂载目录，需在主机创建与容器内相同UID/GID的用户和组：

sh
groupadd -r -g 998 go
useradd -r -g go -u 998 go

然后修改主机目录权限：

sh
chown -R go:go /mnt/persistent-disk/gocd-agent/pipelines
chown -R go:go /mnt/persistent-disk/gocd-agent/ssh