bdpiprava/gocd-agent-dind

GoCD Agent Docker镜像

镜像概述

本镜像基于Alpine 3.5构建，是GoCD的Agent组件，用于连接GoCD服务器执行持续集成/持续部署（CI/CD）任务。支持Docker-in-Docker（DinD）模式，可在容器内运行Docker命令，满足复杂构建场景需求。

核心功能

1. 连接GoCD服务器：通过环境变量指定服务器地址，实现Agent与服务器的通信。
2. Docker-in-Docker支持：以特权模式运行容器，可在Agent内部安装和使用Docker。
3. 自动注册：通过环境变量配置自动注册密钥、资源、环境等，无需手动批准Agent。
4. 卷挂载：支持挂载/godata（存储配置、日志、构建数据）和/home/go（存储凭据等）目录。
5. JVM参数调整：通过环境变量设置JVM系统属性，优化Agent性能。

使用场景

• CI/CD流水线构建：作为GoCD服务器的Agent节点，执行代码编译、测试、部署等任务。
• Docker化构建环境：利用DinD模式，在Agent内部构建和推送Docker镜像。
• 弹性代理集成：与Docker或Swarm弹性代理插件配合，实现Agent的动态扩缩容。

配置说明

基本运行

bash
docker run -d -e GO_SERVER_URL=https://your-gocd-server:8154/go bdpiprava/gocd-agent-dind:0.0.1

注意：需指定镜像版本，不提供latest标签。

Docker-in-Docker模式

以特权模式启动容器：

bash
docker run -d --privileged -e GO_SERVER_URL=https://your-gocd-server:8154/go bdpiprava/gocd-agent-dind:0.0.1

可安装指定版本Docker：

bash
sudo dvm install 17.09.1

自动注册配置

bash
docker run -d \
  -e AGENT_AUTO_REGISTER_KEY=your-registration-key \
  -e AGENT_AUTO_REGISTER_RESOURCES=java,nodejs \
  -e AGENT_AUTO_REGISTER_ENVIRONMENTS=production \
  -e AGENT_AUTO_REGISTER_HOSTNAME=agent-01 \
  bdpiprava/gocd-agent-dind:0.0.1

卷挂载

bash
docker run -v /host/godata:/godata -v /host/home-go:/home/go bdpiprava/gocd-agent-dind:0.0.1

注意：确保挂载目录对容器内go用户（UID 1000）可访问。

JVM参数调整

bash
docker run -e GO_AGENT_SYSTEM_PROPERTIES="-Xmx512m -Dfoo=bar" bdpiprava/gocd-agent-dind:0.0.1

目录结构

故障排查

1. 检查容器状态：docker ps -a
2. 查看容器日志：docker logs CONTAINER_ID
3. 进入容器查看详细日志：docker exec -it CONTAINER_ID /bin/bash，然后查看/godata/logs/*.log

许可证

本镜像基于Apache License 2.0开源协议，详情见：http://www.apache.org/licenses/LICENSE-2.0