用途:让 Azure DevOps Pipeline 跑起来,包括触发、追踪与取消。触发和取消属写入动作,执行前一律把内容列给用户确认。Run ID 即建置 ID,建置结果细节交由 pipelines-build-summary 处理。
主要能力:1) 执行 YAML Pipeline:先以 previewRun 干跑,finalYaml 展开 template 后可核对 stage/job 清单;支持完整 ref 分支(如 refs/heads/main)、指定 commit、templateParameters、仅 allowOverride 为 true 的变量(机密值 isSecret true)及 stagesToSkip(用 stage identifier)。2) 执行 classic Pipeline:改用 Builds API,parameters 为 JSON 字符串。3) 追踪执行:约每 30 秒查一次,累计超 15 分钟先询问是否继续;遇 Checkpoint.Approval 等待核准时转 pipelines-approvals。4) 取消执行中的建置,仅 notStarted 或 inProgress 可取消;不提供删除建置。
使用方式:以 curl 直连 Azure DevOps REST API,组织读环境变量 AZURE_DEVOPS_ORG,PAT 以 -u ":$AZURE_DEVOPS_PAT" 送出(或用 AZURE_DEVOPS_EXT_PAT、Bearer 令牌)。权限:读取需 Build (Read),触发、干跑、取消需 Build (Read & execute)。路径与查询需 URL 编码。
限制:权限不足、令牌失效、参数或分支验证失败会返回错误并停止;classic Pipeline 不支持 Runs API 与干跑;仅 YAML 中定义的变量无法在运行时覆写。
原文还包含多条完整的 curl 示例与 Windows PowerShell 注意事项(如使用 curl.exe、JSON 主体写入暂存文件)。
暂未提供:更多产品价格、平台或效果信息。