gocd/gocd-agent-almalinux-9

GoCD Agent Almalinux容器镜像

基于AlmaLinux 9构建的[***]

问题反馈

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

使用方法

启动容器命令如下：

docker run -d -e GO_SERVER_URL=... gocd/gocd-agent-almalinux-9:v26.1.0

注意：请始终指定版本号，本镜像不发布latest标签。

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

提示：GO_SERVER_URL必须为HTTPS URL且以/go结尾，例如http://ip.add.re.ss:8153/go。

与Docker GoCD服务器配合使用

若已运行名为angry_feynman的GoCD服务器容器：

docker run -d -e GO_SERVER_URL=http://$(docker inspect --format='{{(index (index .NetworkSettings.IPAddress))}}' angry_feynman):8153/go gocd/gocd-agent-almalinux-9:v26.1.0

或若服务器容器已映射端口到主机：

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-almalinux-9:v26.1.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-almalinux-9:v26.1.0

提供AGENT_AUTO_REGISTER_*变量（推荐）可让代理自动被服务器批准，详情见https://docs.gocd.org/26.1.0/advanced_usage/agent_auto_register.html%E3%80%82

SSL配置

通过AGENT_BOOTSTRAPPER_ARGS环境变量配置SSL参数，支持选项见https://docs.gocd.org/26.1.0/installation/ssl_tls/end_to_end_transport_security.html%EF%BC%9A

shell
docker run -d \
    -e AGENT_BOOTSTRAPPER_ARGS='-sslVerificationMode NONE ...' \
    gocd/gocd-agent-almalinux-9:v26.1.0

与Docker/Swarm弹性代理插件配合

本镜像可直接与https://github.com/gocd-contrib/docker-elastic-agents%E5%92%8Chttps://github.com/gocd-contrib/docker-swarm-elastic-agents%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%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代理将配置、日志和构建文件存储在/godata，可挂载/home/go提供SSH私钥等安全凭据：

docker run -v /path/to/godata:/godata -v /path/to/home-dir:/home/go gocd/gocd-agent-almalinux-9:v26.1.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-almalinux-9:v26.1.0

内部目录说明

GoCD代理以go用户运行，关键目录如下：

在任务中运行Docker和Docker Compose

要在任务中执行docker或docker-compose命令，需挂载主机的Docker套接字：

docker run -v /var/run/docker.sock:/var/run/docker.sock gocd/gocd-agent-almalinux-9:v26.1.0

若运行多个代理容器，需设置VOLUME_DIR环境变量指定不同的/godata路径，避免冲突：

docker run -e VOLUME_DIR=/go-agent1/godata -v /host/path:/go-agent1/godata gocd/gocd-agent-almalinux-9:v26.1.0

故障排除

代理无法连接到服务器

1. 检查容器是否运行：docker ps -a
2. 查看容器输出日志：docker logs CONTAINER_ID
3. 查看代理内部日志：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

    http://www.apache.org/licenses/LICENSE-2.0

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.