Jenkins触发器：基于Jira Custom Field的自动化构建

本文叙述基于以下假设前提，将介绍三种在不同的jenkins服务器之间触发Job的方法：

本地Jenkins Server local.jenkins.com
远程Jenkins Server remote.jenkins.com
本地Jenkins Job名 local_job
远程Jenkins Job名
remote_job

需求在local_job完成后自动触发remote_job
一、在remote_job上配置Build Trigger:
步骤：1.在Jenkins Web GUI上配置remote_job的Build Trigger为Trigger build remotely.(其他Build Triggers方式具体见文档，本文不赘述)

2. 在远程Jenkins Server上配置用户：

在Web上进入下面目录创建专用的Jenkins User：Jenkins>Manage Jenkins>Manage Users>Create User. 本文中创建的user为“remote_user”. 然后配置remote_user的API Token(创建完成后，logout当前user，然后以remote_user的身份登录，否则看不到remote_user的API Token)，进入目录Jenkins>People>remote_user>Configure:

此时，在任何网络能够连接到remote.jenkins.com的地方都可以通过执行以下shell命令触发remote_job:

curl -X POST http://remote_user:22b990ddaf51b27476443e443f6f8f6d@remote.jenkins.com/job/remote_job/build?token=remoteToken
3. 如果想通过local_job触发remote job，只需要在local_job中添加一条上面的shell命令即可实现。

二. 从local_job远程触发remote_job
这种方法本质上和第一种方法相同，区别在于第一种方法是在remote_job上进行配置，而这种方法是通过local_job的pipeline实现.

步骤：1. 安装Plugin：Parameterized Remote Trigger. 在Jenkins Web GUI上，Jenkins>Manage Jenkins>Manage Plugin, 找到Parameterized Remote Trigger并安装.

2. 在本地Jenkins Server中配置Remote Trigger，认证方式推荐使用username+api token（由于username+password方式可能会由于安全要求经常变更），进入配置目录：Jenkins>Manage Jenkins>Configure System

4. local_job需要是一个pipeline project，使用Pipeline Syntax，填写需要的参数，生成pipeline代码即可（如果没有进行上一步的配置，也可以在Pipeline代码中指定这些配置信息,下图的情况是已经按照上一步进行了配置）：

在local_job的pipeline中加上刚才生成的代码即可触发remote_job。

三. 通过检测远程文件变化间接触发
前两种方式都有一个前提，那就是本地Jenkins Server和远程Jenkins Server之间网络必须互通，如果他们分别在两个隔绝的网络环境中，则前两种方式是无法实现远程触发的。此时可以通过一个中间文件的内容作为标志，以决定是否触发remote_job.

本地Jenkins Servers上的任务local_job每次成功完成后，更新AWS S3上的文件s3://jenkins-trigger/REVISION的内容。

在远程Jenkins Server上，remote_job同级目录下新建一个pipeline Jenkins Job，命名为scanner，用它来调用remote_job,设定其每五分钟检测一次位于AWS S3上的文件s3://jenkins-trigger/REVISION的内容，与远程Jenkins Server上保存的该文件副本进行比较，如果内容不相同，则触发remote_job任务。

示例代码，在local_job中的pipeline代码：

node{
 stage('upload new REVISION to S3'){
 sh '''
 echo `date` > ~/REVISION.local
 '''
#credentialsId需要在本地Jenkins Server上设置为有权限上传文件到s3://jenkins-trigger/的AWS credentials.
 wrap([$class: 'AmazonAwsCliBuildWrapper', credentialsId: 's3-trigger']) {
 sh "aws s3 cp ~/REVISION.local s3://jenkins-trigger/REVISION"
 }
 }
}
示例代码，在scanner中的pipeline代码：node{
#将S3上的文件REVISON(最新的内容)，REVISION.old(上次触发remote时的内容)下载到remote.jenkins.com上并读取内容进行比较。
 def current_revision
 def old_revision
 stage("check REVISION"){
 wrap([$class: 'AmazonAwsCliBuildWrapper', credentialsId: 's3-trigger']) {
 sh "aws s3 cp s3://jenkins-trigger/REVISION ./REVISION.s3"
 sh "aws s3 cp s3://jenkins-trigger/REVISION.old ./REVISION.local"
 }
 current_revision = readFile("./REVISION.s3").trim()
 old_revision = readFile("./REVISION.local").trim()
 }
#如果REVISION和REVISION.old的内容不一样，则说明local_job被执行过，则应触发remote_job,每次触发remote_job之前，更新REVISION.old文件内容
 stage("test"){
 if (current_revision != old_revision){
 wrap([$class: 'AmazonAwsCliBuildWrapper', credentialsId: 's3-trigger']) {
 sh "aws s3 cp ./REVISION.s3 s3://jenkins-trigger/REVISION.old"
 }
 build job: "./remote_job" 
 }
 }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.