gocdexperimental/gocd-agent-alpine

GoCD Agent Alpine容器镜像

基于Alpine 3的GoCD代理容器镜像。

问题与反馈

请在 https://github.com/gocd/gocd 提交相关问题和反馈。

镜像概述与主要用途

该镜像提供了轻量级的GoCD代理环境，基于Alpine Linux构建，用于连接GoCD服务器并执行持续集成/持续部署(CI/CD)任务。代理负责接收服务器分配的构建任务，执行构建流程并将结果反馈给服务器，是GoCD CI/CD pipeline的核心执行组件。

核心功能与特性

• 轻量级基础：基于Alpine 3，镜像体积小，资源占用低
• 自动注册：支持通过环境变量自动注册到GoCD服务器并获得批准
• 灵活配置：支持SSL参数配置、JVM参数调整
• 数据持久化：可通过卷挂载持久化配置、日志和构建数据
• 兼容性：与Docker和Docker Swarm弹性代理插件无缝集成

使用场景与适用范围

• 作为GoCD CI/CD pipeline的构建执行节点
• 在Docker或Kubernetes环境中部署GoCD代理集群
• 需要轻量级构建代理的开发/测试环境
• 与Docker Swarm或Kubernetes等容器编排平台集成的弹性构建场景

使用方法与配置说明

基本使用

启动容器并连接到GoCD服务器：

bash
docker run -d -e GO_SERVER_URL=... gocd/gocd-agent-alpine:v25.4.0

注意：必须始终指定版本标签，不提供latest标签。

GO_SERVER_URL必须是HTTPS URL并以/go结尾，例如：http://ip.add.re.ss:8153/go

与Docker GoCD服务器配合使用

如果已运行https://hub.docker.com/r/gocd/gocd-server/%E4%B8%94%E5%AE%B9%E5%99%A8%E5%90%8D%E4%B8%BA%60angry_feynman%60%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E6%96%B9%E5%BC%8F%E8%BF%9E%E6%8E%A5%E4%BB%A3%E7%90%86%EF%BC%9A

方法一：使用容器IP

bash
docker run -d -e GO_SERVER_URL=http://$(docker inspect --format='{{(index (index .NetworkSettings.IPAddress))}}' angry_feynman):8153/go gocd/gocd-agent-alpine:v25.4.0

方法二：使用主机端口映射 如果GoCD服务器容器已将端口映射到主机：

bash
docker run -d -e GO_SERVER_URL=http://ip_of_host_machine:$(docker inspect --format='{{(index (index .NetworkSettings.Ports "8153/tcp") 0).HostPort}}' angry_feynman)/go gocd/gocd-agent-alpine:v25.4.0

可用配置选项

代理自动注册

通过环境变量配置自动注册，服务器将自动批准代理：

bash
docker run -d \
        -e AGENT_AUTO_REGISTER_KEY=... \
        -e AGENT_AUTO_REGISTER_RESOURCES=... \
        -e AGENT_AUTO_REGISTER_ENVIRONMENTS=... \
        -e AGENT_AUTO_REGISTER_HOSTNAME=... \
        gocd/gocd-agent-alpine:v25.4.0

详细信息参见GoCD官方文档：代理自动注册

SSL配置

通过AGENT_BOOTSTRAPPER_ARGS环境变量配置SSL参数：

bash
docker run -d \
    -e AGENT_BOOTSTRAPPER_ARGS='-sslVerificationMode NONE ...' \
    gocd/gocd-agent-alpine:v25.4.0

支持的选项参见官方文档

与Docker/Swarm弹性代理插件配合使用

该镜像可直接与以下插件配合使用，无需特殊配置：

• https://github.com/gocd-contrib/docker-elastic-agents
• https://github.com/gocd-contrib/docker-swarm-elastic-agents

卷挂载

GoCD代理将配置、日志和构建数据存储在/godata目录，可挂载该目录实现数据持久化。/home/go目录可用于存储安全凭证（如SSH私钥）：

bash
docker run -v /path/to/godata:/godata -v /path/to/home-dir:/home/go gocd/gocd-agent-alpine:v25.4.0

注意：确保主机目录/path/to/home-dir和/path/to/godata可被容器内的go用户（uid 1000）访问。

JVM参数调整

通过GOCD_AGENT_JVM_OPTS环境变量调整JVM参数（内存、堆大小等）：

bash
docker run -e GOCD_AGENT_JVM_OPTS="-Dfoo=bar -Xmx512m" gocd/gocd-agent-alpine:v25.4.0

底层信息

GoCD代理以go用户运行，主要目录说明：

在任务中运行docker和docker-compose

要在构建任务中执行docker或docker-compose命令，需共享主机的docker socket：

bash
docker run -v /var/run/docker.sock:/var/run/docker.sock gocd/gocd-agent-alpine:v25.4.0

注意：当运行多个代理容器时，需通过VOLUME_DIR环境变量为每个容器设置不同的/godata路径，避免冲突。例如：

bash
docker run -e VOLUME_DIR=/go-agent1/godata -v /host/path/go-agent1/godata:/go-agent1/godata gocd/gocd-agent-alpine:v25.4.0

故障排除

代理无法连接到服务器

1. 检查容器是否运行：docker ps -a
2. 查看容器标准输出日志：docker logs CONTAINER_ID
3. 检查代理日志：

   bash
   docker exec -it CONTAINER_ID /bin/bash
   less /godata/logs/*.log
   

许可证

plain
Copyright Thoughtworks, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    [***]

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.