用途:通过 orbit CLI 对自建 GoCD 实例进行全面的 REST API 管理,覆盖流水线、流水线组、代理、环境、配置仓库、服务器管理、用户、角色、授权、插件、备份、材料、制品库、弹性代理集群与配置、阶段与作业、服务器配置、模板、包与包仓库、通知过滤、仪表盘、访问令牌、密钥配置和服务器版本。
主要能力:所有命令格式为 orbit -p <profile> gocd <command> [flags],别名 cd;支持 -o json 与 -o yaml 结构化输出。流水线命令支持 CRUD、状态、历史、触发(可带环境变量覆盖与加密安全变量、固定材料版本)、暂停/恢复、评论、导出、比较、锁定;还支持从文件创建(可等待注册、从已有流水线克隆加密变量、复制环境变量、与文件比对差异)。其余命令组包括流水线组、代理、环境、配置仓库、服务器健康与维护模式、服务器配置、用户、角色、授权配置、插件、备份、材料、制品库、集群配置、弹性代理配置、阶段与作业、加密、模板、包仓库、包、通知过滤、仪表盘、版本、访问令牌、密钥配置。作业日志与制品命令在 --job 错误时会提示实际阶段与作业名;作业制品用于获取构建产物,与制品库配置命令不同。
使用方式:需先安装 orbit CLI(macOS/Linux 可用 Homebrew:brew install jorgemuza/tap/orbit,或脚本:curl -sSfL https://raw.githubusercontent.com/jorgemuza/orbit/main/install.sh | sh;Windows 用 Scoop 添加 jorgemuza 桶后安装 orbit),并在 ~/.config/orbit/config.yaml 中配置带 gocd 服务的配置档,提供有效凭据(API 令牌或基本认证,可存为 1Password 或 Infisical 引用),base_url 为必填。自签证书实例可加 tls_skip_verify: true,代理可加 proxy: socks5://host:port。
适用场景与限制:面向自建 GoCD(GoCD 始终为自托管),兼容 GoCD 25.x;文档中所有 API 版本均针对 api.gocd.org/25.1.0 验证。仪表盘兼容 v4 与旧格式,代理列表/获取兼容 free_space 为数字或字符串、环境为数组或对象(v7),流水线实例采用三种回退策略。删除等操作在终端会提示,脚本或 CI 中需加 --yes。文档未提供未列出的功能、收费与价格信息。