gocdexperimental/gocd-agent-debian-12

GoCD Agent Debian容器镜像

基于Debian 12的GoCD Agent容器镜像。

问题与反馈

如有问题或反馈，请提交至 https://github.com/gocd/gocd%E3%80%82

使用方法

使用以下命令启动容器：

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

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

此命令将启动GoCD Agent并连接至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

docker run -d -e GO_SERVER_URL=http://$(docker inspect --format='{{(index (index .NetworkSettings.IPAddress))}}' angry_feynman):8153/go gocd/gocd-agent-debian-12: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-12: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-12: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-12:v25.3.0

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

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

挂载卷

GoCD Agent的配置、日志及构建任务均存储在/godata目录。如需提供SSH私钥等安全凭证，可挂载/home/go目录。

docker run -v /path/to/godata:/godata -v /path/to/home-dir:/home/go gocd/gocd-agent-debian-12: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-12:v25.3.0

底层结构

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

在任务中运行Docker和Docker Compose

如需在任务中执行docker或docker-compose命令，需将主机的Docker套接字作为卷共享（常规做法）。由于Docker守护进程负责挂载卷，任务中需挂载的文件路径（通常在/godata/pipelines内）必须与主机路径一致。

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

故障排除

GoCD Agent无法连接服务器

• 检查容器是否运行：docker ps -a
• 查看标准输出日志排查故障：docker logs CONTAINER_ID
• 检查Agent日志：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.