gocdexperimental/gocd-agent-debian-11 Docker 镜像 - 轩辕镜像

GoCD Agent Debian容器镜像

GoCD agent容器镜像，基于Debian 11构建。

问题与反馈

如遇问题或有反馈，请提交至 [***]

使用方法

通过以下命令启动容器：

docker run -d -e GO_SERVER_URL=... gocd/gocd-agent-debian-11:v25.3.0

注意：请务必始终提供版本号。我们不发布 latest 标签，且暂无此计划。

此命令将启动GoCD agent并连接至 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-debian-11: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-debian-11: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-debian-11: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-debian-11:v25.3.0

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

此镜像可与 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-debian-11: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-debian-11:v25.3.0

内部结构

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

在作业中运行docker和docker-compose

如需在作业中执行 docker 和 docker-compose 命令，需将主机的docker socket作为卷共享（常规做法）。此时，作业中定义的卷挂载路径（通常在 /godata/pipelines 内）需与主机路径一致，以便主机上的docker守护进程能找到文件。

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

故障排除

GoCD代理无法连接服务器

• 检查容器是否运行：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.