GoCD代理Docker容器镜像

基于Docker dind的GoCD代理容器镜像。

问题与反馈

请确保在[***]

使用方法

使用以下命令启动容器：

docker run --privileged -d -e GO_SERVER_URL=... gocd/gocd-agent-docker-dind:v25.3.0

注意：请务必始终指定版本。我们不发布latest标签，也不打算发布。

此命令将启动GoCD代理并连接到GO_SERVER_URL指定的GoCD服务器。

注意：GO_SERVER_URL必须是HTTPS URL并以/go结尾，例如[***]

与Docker GoCD服务器配合使用

如果您已运行gocd-server容器且容器名为angry_feynman，可通过以下方式连接gocd-agent容器：

docker run --privileged -d -e GO_SERVER_URL=[***] inspect --format='{{(index (index .NetworkSettings.IPAddress))}}' angry_feynman):8153/go gocd/gocd-agent-docker-dind:v25.3.0

或者

如果GoCD服务器容器已将端口映射到主机：

docker run --privileged -d -e GO_SERVER_URL=http://<主机IP>:$(docker inspect --format='{{(index (index .NetworkSettings.Ports "8153/tcp") 0).HostPort}}' angry_feynman)/go gocd/gocd-agent-docker-dind:v25.3.0

可用配置选项

代理自动注册

docker run --privileged -d \
        -e AGENT_AUTO_REGISTER_KEY=... \
        -e AGENT_AUTO_REGISTER_RESOURCES=... \
        -e AGENT_AUTO_REGISTER_ENVIRONMENTS=... \
        -e AGENT_AUTO_REGISTER_HOSTNAME=... \
        gocd/gocd-agent-docker-dind:v25.3.0

如果提供了AGENT_AUTO_REGISTER_*变量（建议提供），代理将被服务器自动批准。详见GoCD官网的自动注册文档。

SSL配置

要配置SSL参数，可通过环境变量AGENT_BOOTSTRAPPER_ARGS传递参数。支持的选项详见此文档。

shell
    docker run --privileged -d \
    -e AGENT_BOOTSTRAPPER_ARGS='-sslVerificationMode NONE ...' \
    gocd/gocd-agent-docker-dind:v25.3.0

卷挂载

GoCD代理将所有配置、日志和构建文件存储在/godata。如需提供SSH私钥等安全凭据，可挂载/home/go。

docker run --privileged -v /path/to/godata:/godata -v /path/to/home-dir:/home/go gocd/gocd-agent-docker-dind:v25.3.0

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

调整JVM选项（内存、堆等）

可通过环境变量GOCD_AGENT_JVM_OPTS调整JVM选项。

docker run --privileged -e GOCD_AGENT_JVM_OPTS="-Dfoo=bar" gocd/gocd-agent-docker-dind:v25.3.0

内部结构

GoCD代理以go用户运行，各目录位置如下：

故障排除

GoCD代理无法连接服务器

• 检查Docker容器是否运行：docker ps -a
• 检查STDOUT输出是否有失败指示：docker logs CONTAINER_ID
• 检查代理日志：docker exec -it CONTAINER_ID /bin/bash，然后在容器内运行less /godata/logs/*.log

许可证

plain
版权所有 Thoughtworks, Inc.

根据Apache许可证2.0版（"许可证"）授权；
除非遵守许可证，否则您不得使用此文件。
您可以在以下地址获取许可证副本：

    [***]

除非适用***要求或书面同意，软件
根据许可证分发的软件按"原样"分发，
不附带任何明示或暗示的担保或条件。有关许可证下的权限和
限制的具体语言，请参阅许可证。