Jenkins远程API如何实现CLI的-s/-v构建等待并获取输出？

好问题！确实Jenkins CLI的build -v -s用起来特别顺手，一站式完成触发构建、等待结束、拿到完整输出的流程。那有没有办法用单次REST API调用实现同样的效果呢？

先直接给结论：Jenkins原生核心REST API并没有提供一个直接的端点能做到“发起构建+等待完成+返回输出”的同步调用，但针对短运行的作业，有几个变通方案能让你不用自己写轮询逻辑，接近“单次调用”的体验。

方案1：利用插件扩展的wait参数（依赖插件） #

部分Jenkins插件（比如Parameterized Trigger或第三方扩展插件）给构建端点添加了wait参数支持。当你调用buildWithParameters时带上wait=true，请求会保持连接直到构建完成，然后返回构建结果和输出。

示例调用（用curl）：

curl -X POST "http://your-jenkins-url/job/YourJobName/buildWithParameters?wait=true&token=YOUR_BUILD_TOKEN" \
  --user "your-username:your-api-token"

不过要注意，这个方案依赖插件，而且如果作业运行时间稍长，可能会碰到HTTP超时的问题，刚好适合你说的短作业场景。

方案2：通过脚本控制台执行Groovy脚本（推荐短作业） #

这是更灵活且不依赖额外插件的方案——通过REST API调用Jenkins的脚本控制台，在Jenkins服务器端直接执行一段Groovy代码，完成“触发构建→等待完成→获取日志”的全流程，最后把日志返回给客户端。相当于一次API调用搞定所有事，不用客户端做轮询。

示例请求（curl版）：

curl -X POST "http://your-jenkins-url/scriptText" \
  --user "your-username:your-api-token" \
  --data-urlencode "script=
// 获取目标作业
def targetJob = Jenkins.instance.getItemByFullName('YourJobName')
// 触发构建并等待构建实例初始化
def build = targetJob.scheduleBuild2(0).get()
// 等待构建完成
build.waitForCompletion()
// 读取并打印构建日志
def buildLog = build.logFile.text
println buildLog
"

这段Groovy脚本会在Jenkins服务器端执行：

1. 定位到你指定的作业
2. 触发构建并等待构建实例创建完成
3. 一直等到构建结束
4. 读取完整的构建日志并输出

这样你在客户端发起一次请求后，就能直接拿到完整的构建输出，完全匹配CLI的-s -v效果，对短作业来说非常合适，也不用担心客户端超时的问题（因为逻辑都在Jenkins端跑）。

注意事项 #

• 权限要求：你的Jenkins用户需要拥有RunScripts权限，否则会被拒绝执行脚本。
• 长作业风险：如果作业运行时间过长，这个请求会一直保持连接，可能触发客户端或服务器的超时设置，所以只推荐用于短运行作业。
• 安全问题：直接执行Groovy脚本要注意安全，避免传入不可信的参数导致脚本注入风险。

总结 #

如果你用的是短运行作业，最推荐的是方案2——通过脚本控制台的Groovy脚本实现单次API调用完成所有流程，不用自己写轮询逻辑，体验和CLI几乎一致。

内容的提问来源于stack exchange，提问作者willyjoker