用途:让智能体通过 curl 直接调用 Jenkins 远程访问 REST API,完成 CI/CD 操作,不依赖 SDK 或 pip。Jenkins 采用路径寻址,在对象 URL 后加 api/json 读取,POST 到动作路径写入。
主要能力:触发构建(build / buildWithParameters)并跟踪结果;读取构建状态(result / building / duration)与控制台日志;列出和查看作业、队列、节点、视图;通过 API 进行作业增删改(createItem + config.xml、复制、删除、启用/禁用)及构建管理(停止/删除构建)。
使用方式:凭据由调用方注入,包括 base_url、username 和 token(token 仅以变量名引用,值从环境读取,绝不打印)。认证用 HTTP Basic:curl -u "$username:$JENKINS_TOKEN"。路径查 assets/endpoint-index.md;读取用 GET <base_url>/<path>/api/json,并用 ?tree= 缩小响应,含方括号时加 curl -g。写入用 POST,token 认证免 crumb,仅在 403 No valid crumb 时用 scripts/crumb.sh 兜底。构建触发是异步的:先返回队列项,须轮询 queue/item/<id>/api/json 到 .executable 后再读构建状态。
适用场景:需要以脚本方式驱动 Jenkins 构建、查询状态、管理作业与构建的自动化流程。
限制:不提交 Jenkinsfile 或配置 SCM webhook(属 vcs 操作);不负责凭据配置;插件贡献的端点不在保证范围内;无官方 OpenAPI,路径以官方 Remote Access 文档为准,内置 swaggy-jenkins 规范仅为非官方部分交叉校验。