gocdexperimental/gocd-agent-docker-dind

GoCD Agent Docker容器镜像

GoCD代理容器镜像，基于Docker dind构建。

问题与反馈

请在https://github.com/gocd/gocd%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E6%88%96%E5%8F%8D%E9%A6%88%E3%80%82

使用方法

使用以下命令启动容器：

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必须是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%A5gocd-agent%E5%AE%B9%E5%99%A8%EF%BC%9A

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

或者，如果运行GoCD服务器的Docker容器已将端口映射到主机：

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
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.