stakater/gocd-agent

GoCD Agent 镜像文档

镜像概述和主要用途

本镜像为基于Alpine的GoCD代理（Agent），预装了jq、awscli和terraform工具。GoCD是一个开源的持续集成/持续部署（CI/CD）系统，代理节点负责执行GoCD服务器分配的构建、测试和部署任务。本镜像在官方GoCD代理基础上扩展，集成了常用工具，适用于需要与AWS交互、处理JSON数据或使用Terraform管理基础设施的CI/CD流水线。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 预装工具：已集成jq（JSON数据处理工具）、awscli（AWS命令行工具）和terraform（基础设施即代码工具）
• 兼容性：与GoCD服务器完全兼容，可无缝接入现有GoCD环境
• 灵活扩展：支持通过环境变量和挂载卷进行自定义配置

使用场景和适用范围

• GoCD CI/CD流水线中需要与AWS云服务交互的任务（如S3文件操作、EC2实例管理等）
• 需要处理JSON格式数据的构建或部署流程（如解析API响应、配置文件处理）
• 使用Terraform进行基础设施自动化部署的场景
• 对镜像体积和资源占用有要求的CI/CD环境

使用方法和配置说明

基本运行命令

bash
docker run -d \
  --name gocd-agent \
  -e GO_SERVER_URL=https://your-gocd-server:8154/go \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gocd-agent-with-tools

环境变量配置

数据持久化

为确保代理配置和工作目录数据持久化，可挂载本地目录：

bash
docker run -d \
  --name gocd-agent \
  -e GO_SERVER_URL=https://your-gocd-server:8154/go \
  -v /path/to/agent/work:/godata/work \
  -v /path/to/agent/config:/godata/config \
  gocd-agent-with-tools

灵感来源

• GoCD官方代理镜像：https://github.com/gocd/docker-gocd-agent-alpine-3.5
• Alpine glibc镜像：https://github.com/frol/docker-alpine-glibc