Jenkins触发远程Job的几种方式

本文叙述基于以下假设前提，将介绍三种在不同的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"
}
}
}