gocdexperimental/gocd-agent-wolfi Docker 镜像 - 轩辕镜像

GoCD Agent Wolfi 容器镜像

基于Wolfi最新版本的GoCD Agent容器镜像。

问题与反馈

如有问题或反馈，请在 [***] 记录。

使用方法

使用以下命令启动容器：

docker run -d -e GO_SERVER_URL=... gocd/gocd-agent-wolfi: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-wolfi: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-wolfi: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-wolfi: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-wolfi:v25.3.0

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

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

挂载卷

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

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

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

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

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

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

内部结构

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

在作业中运行Docker和docker-compose

要在作业中运行 docker 和 docker-compose 命令，需将主机的Docker socket作为卷共享（这是常规做法）。

此时，由于Docker守护进程会挂载您定义的卷，您要挂载的文件路径（通常在 /godata/pipelines 内）必须保持一致，以便主机上的Docker守护进程能够找到这些文件。

如果运行多个Agent容器，需覆盖 VOLUME_DIR 环境变量，为每个GoCD Agent容器的 /godata 设置不同路径（以避免冲突）。例如，若第一个容器在主机上的卷路径为 /go-agent1/godata，可将容器的 VOLUME_DIR 环境变量设置为 /go-agent1/godata，docker-entrypoint.sh 脚本会自动管理并确保Agent将配置、日志和流水线存储在此路径。

故障排除

GoCD Agent无法连接到服务器

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

许可证

plain
Copyright Thoughtworks, Inc.

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

    [***]

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