gocdexperimental/gocd-agent-almalinux-10

GoCD Agent Almalinux容器镜像

基于Almalinux 10的GoCD代理容器，用于连接GoCD服务器执行自动化构建、测试等CI/CD任务，支持多种配置选项与弹性扩展。

镜像概述

该镜像为GoCD持续集成/持续部署平台的代理组件，基于Almalinux 10系统构建，可与GoCD服务器配合完成流水线任务执行，提供稳定、高效的构建环境。

核心功能

• 自动注册到GoCD服务器，简化代理配置流程
• 支持SSL/TLS安全配置，保障与服务器的通信安全
• 卷挂载功能，持久化存储构建数据与共享凭据
• 可调整JVM参数，优化代理运行性能
• 兼容Docker/Swarm弹性代理插件，实现资源动态扩展
• 支持在任务中运行Docker和docker-compose命令

使用场景

• 与GoCD服务器配合搭建CI/CD流水线，自动化执行代码编译、单元测试等任务
• 弹性扩展构建资源，应对高并发构建需求
• 为不同项目提供隔离的构建环境

配置说明

基础部署

启动代理并连接到指定GoCD服务器：

shell
docker run -d -e GO_SERVER_URL=https://your-gocd-server:8153/go docker.xuanyuan.run/gocd/gocd-agent-almalinux-10:v25.4.0

注意：需指定具体版本（无latest标签），GO_SERVER_URL需以/go结尾。

与GoCD服务器容器配合

若GoCD服务器容器名为gocd-server，可通过以下命令连接：

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

自动注册代理

通过环境变量自动注册并获服务器批准：

shell
docker run -d \
  -e AGENT_AUTO_REGISTER_KEY=your-registration-key \
  -e AGENT_AUTO_REGISTER_RESOURCES=java,nodejs \
  -e AGENT_AUTO_REGISTER_ENVIRONMENTS=production \
  -e AGENT_AUTO_REGISTER_HOSTNAME=agent-01 \
  docker.xuanyuan.run/gocd/gocd-agent-almalinux-10:v25.4.0

SSL配置

通过AGENT_BOOTSTRAPPER_ARGS设置SSL参数：

shell
docker run -d \
  -e AGENT_BOOTSTRAPPER_ARGS='-sslVerificationMode NONE' \
  docker.xuanyuan.run/gocd/gocd-agent-almalinux-10:v25.4.0

卷挂载

持久化构建数据与共享凭据：

shell
docker run -d \
  -v /host/path/godata:/godata \
  -v /host/path/home:/home/go \
  docker.xuanyuan.run/gocd/gocd-agent-almalinux-10:v25.4.0

注意：确保挂载目录可被容器内go用户（UID 1000）访问。

JVM参数调整

通过GOCD_AGENT_JVM_OPTS优化JVM性能：

shell
docker run -d \
  -e GOCD_AGENT_JVM_OPTS="-Xmx512m -Xms256m" \
  docker.xuanyuan.run/gocd/gocd-agent-almalinux-10:v25.4.0

故障排除

• 检查容器状态：docker ps -a
• 查看容器日志：docker logs <容器ID>
• 进入容器查看详细日志：docker exec -it <容器ID> less /godata/logs/*.log

许可证

该镜像遵循Apache License 2.0协议：

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.