通过http请求启动jenkins任务
简介：
实战通过http请求触发jenkins任务的构建，并且查询构建状态
欢迎访问我的GitHub
这里分类和汇总了欣宸的全部原创(含配套源码)：
https://github.com/zq2599/blog_demos
- 由于工作需要，要在程序中通过http请求触发jenkins任务的构建，并且查询构建状态，在此记录下来作为备忘；
介绍
- 整体情况如下图所示，通过浏览器提交到web服务器的请求，会导致web服务器向Jenkins发起一次http请求，Jenkins收到请求后开始构建任务；
- 总的来说，为了达到远程触发Jenkins任务的目的，需要做以下操作：
- 安装远程授权的插件"Build Authorization Token Root Plugin"
- 全局设置；
- 生成授权token；
- 将Jenkins任务设置成可以远程触发；
- 验证远程触发是否正常；
关于Jenkins的安装和设置
安装插件
- 先安装远程授权的插件"Build Authorization Token Root Plugin"。
- 如下图，"系统管理"->"插件管理"：
- 选中"Avaliable"这个Tab页，搜索插件"Build Authorization Token Root Plugin",然后安装，如下图：
设置
- 为了远程触发任务成功，要先做以下设置：
- 如下图，点击"系统管理"->"全局安全配置"：
- 如下图，取消勾选红框中的"Prevent Cross Site Request Forgery exploits"单选框：
- 如下图，勾选红框中的"Allow anonymous read access"，这样可以远程查询任务状态：
- 点击页面底部的"保存"按钮；
- 如下图，点击右上角的用户名称进入用户设置页面，再点击红框3中的"Add new Token"按钮；
- 如下图，点击红框中的"Generate"按钮，会生成token：
- 如下图，红框中就是生成的token，此处保存下来，稍后会用到：
创建任务
- 如下图，Build Triggers的设置勾选第一个"Trigger builds remotely (e.g., from scripts)"，红框2中填入前面生成的token：
- 点击底部的"Save"按钮保存任务；
- 至此，相关的设置工作已经完成，我们来验证一下吧；
验证远程触发Jenkins任务
- 为了调整参数方便，我这里使用了postman来发起http请求，您也可以选择写代码发起；
- Jenkins服务器的IP地址是192.168.1.103，因此整个url地址就是：http://192.168.1.103:8080/buildByToken/buildWithParameters
- 请求类型是POST，请求参数有四个，如下列表所示：
| 参数名 |
参数值 |
说明 |
| job |
hello-world |
Jenkins上创建的任务名 |
| token |
11ccef68782a94c7f393a1bc2247523de2 |
前面生成的token，远程验证使用 |
| userName |
Tom |
任务中增加的业务参数 |
| cause |
123456 |
这个参数在查询任务详情的时候可以查到 |
- 上述所有参数，在postman上填写的效果如下图所示，注意要选中红框中的tab页填写参数：
- 在postman页面上点击"Send"按钮发起请求，收到的响应没有body，只有header，返回码是201表示成功，如下图所示：
- 此时去Jenkins页面上看看，任务已经被触发，并且输出的脚本中把userName参数也成功打印了，如下图：
查询任务
- 有时候我们通过程序发起http请求触发了任务后，还想通过http请求获取任务的执行状态，这里介绍一下我这现在的做法：
- 如下图，发起GET请求，获取所有构建情况，红框中就是每次任务的id，请求请求地址是：http://192.168.1.103:8080/job/hello-world/api/json
- 上面已经得到了四个任务ID：1、2、3、4，接下来发四次请求查询每个任务的详情，查询4号任务的地址是：http://192.168.1.103:8080/job/hello-world/4/api/json ，得到的结果如下图所示：
- 注意上图红框中的note字段，该字段的值"123456"，就是我们在POST触发任务时的cause字段，所以，这个字段只要能对上，就表示该任务就是您之前远程触发的任务了，因此请在触发的时候保证cause字段的唯一性；
- 至此，远程触发Jenkins任务的实战就完成了，希望能给您做自动化构建的时候提供一些参考；
欢迎关注阿里云开发者社区博客：程序员欣宸
学习路上，你不孤单，欣宸原创一路相伴...
