gocd/gocd-agent-wolfi

GoCD Agent Wolfi容器镜像

基于Wolfi最新版构建的GoCD代理容器镜像。

问题与反馈？

请在https://github.com/gocd/gocd%E6%8F%90%E4%BA%A4%E7%9B%B8%E5%85%B3%E9%97%AE%E9%A2%98%E3%80%82

使用方法

使用以下命令启动容器：

shell
docker run -d -e GO_SERVER_URL=... gocd/gocd-agent-wolfi:v25.4.0

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

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

注意：GO_SERVER_URL必须是HTTPS 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

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

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

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

可用配置选项

代理自动注册

shell
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.4.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.4.0

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

此镜像可与https://github.com/gocd-contrib/docker-elastic-agents%E5%92%8Chttps://github.com/gocd-contrib/docker-swarm-elastic-agents%E8%89%AF%E5%A5%BD%E9%85%8D%E5%90%88%EF%BC%8C%E6%97%A0%E9%9C%80%E7%89%B9%E6%AE%8A%E9%85%8D%E7%BD%AE%E3%80%82

挂载卷

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

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

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

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

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

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

底层细节

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

在作业中运行docker和docker-compose

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

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

故障排除

GoCD代理无法连接到服务器

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