gocdexperimental/gocd-agent-ubuntu-22.04 Docker 镜像 - 轩辕镜像

GoCD代理Ubuntu容器镜像

基于Ubuntu 22.04的GoCD代理容器镜像，用于连接GoCD服务器并执行构建任务。

问题与反馈

请在GitHub仓库提交相关问题。

使用方法

基本运行命令

使用以下命令启动容器：

docker run -d -e GO_SERVER_URL=... gocd/gocd-agent-ubuntu-22.04: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 -d -e GO_SERVER_URL=[***] inspect --format='{{(index (index .NetworkSettings.IPAddress))}}' angry_feynman):8153/go gocd/gocd-agent-ubuntu-22.04:v25.3.0

或者

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

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

可用配置选项

代理自动注册

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-ubuntu-22.04:v25.3.0

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

SSL配置

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

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

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

此镜像可与Docker弹性代理插件和Docker Swarm弹性代理插件良好配合，无需特殊配置。

卷挂载

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

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

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

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

可通过环境变量GOCD_AGENT_JVM_OPTS调整JVM参数：

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

内部机制

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

在任务中运行Docker和docker-compose

要在任务中运行docker和docker-compose，需将主机Docker套接字作为卷共享。此时，/godata/pipelines内的文件路径需保持一致，以便主机Docker守护进程访问。

若运行多个代理容器，需通过VOLUME_DIR环境变量为每个容器的/godata指定唯一路径（避免冲突）。例如，主机卷路径为/go-agent1/godata时，设置VOLUME_DIR=/go-agent1/godata，入口脚本将自动管理配置、日志和构建存储位置。

故障排除

代理无法连接服务器

• 检查容器状态：docker ps -a
• 查看容器输出日志：docker logs CONTAINER_ID
• 检查代理内部日志：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.