码云Webhook触发Jenkins自动构建 - Jenkins演练（一）

奥尔覅几22

　　今天自己看着插件文档摸索了一下，实现了git push后Webhook自动触发Jenkins进行代码构建，可通用gitlab、github等平台，中文关于这方面自动部署的文档比较少，所以把我的学习过程记录下来，让其他人少走点弯路。
　　模拟场景：开发人员在dev分支提交代码后，Jenkins自动构建和部署，非dev分支提交代码不会触发。
　　实战环境：码云（git.oschina.net）、Jenkins（可在公网访问）、插件Generic Webhook Trigger
　　步骤1：
　　码云新增一个项目，新增两个分支（uat、dev），放一些文件

　　步骤2：
　　Jenkins安装Generic Webhook Trigger插件，插件的文档在这里（https://plugins.jenkins.io/generic-webhook-trigger）

　　步骤3：
　　新建一个自由任务，Geneal留空不影响本次实验；源码管理填入码云的项目地址，添加码云的登陆用户和密码；本次实验是构建dev分支，所以我填了 */dev

　　步骤4：
　　构建触发器这一步比较关键，卡了好久，首先我们先去看看码云关于Webhook文档（http://git.mydoc.io/?t=154711 ），我们要抓取研发push这个Webhook POST过来的数据，然后根据里面内容关键字ref判断是否为开发分支，如果是开发分支，则让Jenkins拉开发分支最新的代码下来构建。所以图四，勾选插件触发器，给抓出来的数据起个变量名ref，抓取内容为$.ref（看码云的文档）。

　　好，稍微下来一点，我们只需要获取POST数据，header和request不用理。接下来也很关键，定义过滤出来什么字串才触发这个任务。所以使用正则匹配，text为匹配出什么结果就触发这个任务，于是我们填入刚才抓取临时存放的变量$ref，注意这里不是原始数据的$.ref。

　　步骤5：剩下就是告诉拉完代码下来之后做什么操作了，后面的文章会讲到，这里我就随便输出点东西了。

　　步骤6：点击保存之后，回到码云的项目管理页面，填入URL
　　URL格式为 http://有读权限的用户名:该用户名密码@jenkis地址/generic-webhook-trigger/invoke
　　密码可不填（看了文档还没明白是包含在哪里，还得研究）

　　点击测试，返回ok就说明接口能用了，如果返回如下，则用户名密码可能没填或者没对。
{"status":"ok","data":{"triggerResults":{"ANY":"Did not find any jobs to trigger!　　
The user invoking /generic-webhook-trigger/invoke must have read permission to any
　　
jobs that should be triggered. You may try adding http://user:passw@url... or configuring
　　
and passing an authentication token like ...trigger/invoke?token=TOKENHERE"}}}
　　最后，在dev分支提交代码，就会触发任务了，至此需求完成。

　　ps：码云点测试按钮默认是触发master push，实验过程有问题，可以只勾选一项，不作判断，就可以测试触发了，如下图。