travix/gocd-agent-gcloud
自动构建
travix
用于在容器中运行带有Google Cloud SDK的GoCD Agent的Docker镜像。
3 次收藏下载次数: 0状态：自动构建维护者：travix仓库类型：镜像最近更新：2 年前
travix/gocd-agent-gcloud 镜像文档
镜像概述和主要用途
本镜像继承自 travix/gocd-agent:latest，并额外集成了 gcloud 包。它提供了在容器环境中运行 GoCD Agent 的能力，同时支持通过 Google Cloud SDK 执行与 Google Cloud 平台相关的 CI/CD 操作。
核心功能和特性
- 基于官方 GoCD Agent 镜像构建，保留其全部核心功能
- 集成 Google Cloud SDK (gcloud)，支持 GCP 相关命令行操作
- 可通过环境变量灵活配置 Agent 连接参数、资源标签和环境分配
- 支持挂载外部卷以持久化工作目录、密钥和日志文件
- 兼容 Docker socket 挂载，实现容器内 Docker 操作（需注意安全风险）
使用场景和适用范围
适用于需要在 GoCD CI/CD 流程中集成 Google Cloud 服务的场景，例如：
- 部署应用到 Google Cloud Platform (GCP)
- 执行 GCP 资源管理和配置操作
- 在 CI/CD 流水线中使用 gcloud 命令行工具
- 需要容器化运行 GoCD Agent 并具备 GCP 集成能力的构建环境
使用方法和配置说明
基本运行命令
shdocker run -d travix/gocd-agent-gcloud:latest
环境变量配置
通过以下环境变量可自定义 Agent 行为：
| 名称 | 描述 | 默认值 |
|---|---|---|
| GO_SERVER | 要连接的 GoCD Server 主机名或 IP 地址 | localhost |
| GO_SERVER_PORT | GoCD Server 的 HTTP 端口 | 8153 |
| AGENT_MEM | Java 虚拟机初始内存 (-Xms) | 128m |
| AGENT_MAX_MEM | Java 虚拟机最大内存 (-Xmx) | 256m |
| AGENT_KEY | 服务器端设置的 Agent 自动注册密钥 | |
| AGENT_RESOURCES | 自动注册时设置的资源标签（逗号分隔） | |
| AGENT_ENVIRONMENTS | 自动注册时分配的环境（逗号分隔） | |
| AGENT_HOSTNAME | Agent 主机名，默认使用容器实际主机名 | |
| DOCKER_GID_ON_HOST | 主机 Docker 组的 GID，用于无 sudo 使用 Docker socket |
配置示例
连接自定义 GoCD Server：
shdocker run -d \ -e "GO_SERVER=gocd.yourdomain.com" \ travix/gocd-agent-gcloud:latest
使用自动注册密钥：
shdocker run -d \ -e "GO_SERVER=gocd.yourdomain.com" \ -e "AGENT_KEY=388b633a88de126531afa41eff9aa69e" \ travix/gocd-agent-gcloud:latest
配置资源标签、环境和主机名：
shdocker run -d \ -e "GO_SERVER=gocd.yourdomain.com" \ -e "AGENT_KEY=388b633a88de126531afa41eff9aa69e" \ -e "AGENT_RESOURCES=deploy-x,deploy-z" \ -e "AGENT_ENVIRONMENTS=Production" \ -e "AGENT_HOSTNAME=deploy-agent-01" \ travix/gocd-agent-gcloud:latest
挂载 Docker 组件（安全风险提示）：
shdocker run -d \ -e "GO_SERVER=gocd.yourdomain.com" \ -e "DOCKER_GID_ON_HOST=$(getent group docker | cut -d: -f3)" \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /usr/bin/docker:/usr/bin/docker \ travix/gocd-agent-gcloud:latest
安全注意：挂载 Docker socket 和二进制文件会使容器间接获得主机的广泛访问权限，存在安全风险。
挂载卷配置
可挂载以下目录实现数据持久化或资源共享：
| 目录路径 | 描述 | 重要性说明 |
|---|---|---|
| /var/lib/go-agent/pipelines | 存储流水线工作副本 | 建议定期清理，非必须挂载 |
| /var/log/go-agent | 存储 Agent 日志（同时输出到标准输出） | 建议通过标准输出收集日志，非必须挂载 |
| /var/go/.ssh | SSH 密钥存储目录（用于版本控制系统访问） | 不建议嵌入密钥，建议挂载 |
| /var/go/.gcloud | Google Cloud 服务账号密钥存储目录 | 不建议嵌入密钥，建议挂载 |
| /var/run/docker.sock | 主机 Docker socket | 注意：存在安全风险 |
| /usr/bin/docker | 主机 Docker 二进制文件 | 注意：存在安全风险 |
挂载示例
shdocker run -d \ -e "GO_SERVER=gocd.yourdomain.com" \ -e "AGENT_KEY=388b633a88de126531afa41eff9aa69e" \ -e "AGENT_RESOURCES=deploy-x,deploy-z" \ -e "AGENT_ENVIRONMENTS=Production" \ -e "AGENT_HOSTNAME=deploy-agent-01" \ -v /mnt/persistent-disk/gocd-agent/pipelines:/var/lib/go-agent/pipelines \ -v /mnt/persistent-disk/gocd-agent/logs:/var/log/go-agent \ -v /mnt/persistent-disk/gocd-agent/ssh:/var/go/.ssh \ -v /mnt/persistent-disk/gocd-agent/gcloud:/var/go/.gcloud \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /usr/bin/docker:/usr/bin/docker \ travix/gocd-agent-gcloud:latest
权限配置
为确保容器进程可读写挂载目录，需在主机创建匹配的用户和组：
shgroupadd -r -g 999 go useradd -r -g go -u 999 go
修改主机目录权限：
shchown -R go:go /mnt/persistent-disk/gocd-agent/pipelines chown -R go:go /mnt/persistent-disk/gocd-agent/ssh chown -R go:go /mnt/persistent-disk/gocd-agent/gcloud
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 版本下载页面。
更多 gocd-agent-gcloud 镜像推荐
datadog/agent
datadog
新Datadog Agent的Docker容器，用于运行该代理以收集、处理并发送监控数据至Datadog平台。
172 次收藏10亿+ 次下载
11 天前更新
portainer/agent
portainer
Portainer是一款高效的容器管理平台，您可将Kubernetes容器编排平台、Docker及Podman容器引擎等主流容器环境便捷连接至该平台，实现对各类容器环境的集中化管理、可视化监控与高效运维操作，有效简化复杂容器架构的管理流程，提升容器部署、维护的效率与安全性。
292 次收藏10亿+ 次下载
26 天前更新
docker/ucp-agent
Docker 官方工具与组件镜像
暂无描述
13 次收藏5亿+ 次下载
5 年前更新
grafana/agent
grafana
暂无描述
25 次收藏1亿+ 次下载
27 天前更新
mirantis/ucp-agent
mirantis
暂无描述
1亿+ 次下载
18 天前更新
mirantis/ucp-agent-win
mirantis
暂无描述
1亿+ 次下载
18 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"