Jenkins - 触发器

触发方式

jenkins自带的job触发方式

Generic Webhook Trigger插件

在需要外界其他系统触发Jenkins任务的场景，通常使用Generic Webhook Trigger插件来配置 Jenkins 触发器
Generic Webhook Trigger 插件允许使用 Webhook将外部系统与 Jenkins 集成。
通过配置 Webhook，在特定事件发生时，外部系统可以触发Jenkins 构建。

插件安装完成后，在pipeline类型项目中可以看到Generic Webhook Trigger 选项

勾选后，会出现提示信息和参数填写框

示例-1 解析Request参数

配置请求URL中传递的参数

配置触发的token参数（Token值具有唯一性，避免同时出发其他配置相同的任务）

设置打印调试日志（用于调试和排错）

对应的pipeline内容

pipeline {agent {label 'master'}stages {stage('web-trigger') {steps {script {echo "${version}"echo "${username}"}}}}
}

curl命令模拟请求测试

curl "http://192.168.16.200:8080/generic-webhook-trigger/invoke?token=test-web-trigger&version=1.1.1&username=jenkins"

curl命令测试结果

$ curl "http://192.168.16.200:8080/generic-webhook-trigger/invoke?token=test-web-trigger&version=1.1.1&username=jenkins" | python -m json.tool% Total    % Received % Xferd  Average Speed   Time    Time     Time  CurrentDload  Upload   Total   Spent    Left  Speed
100   254  100   254    0     0  45035      0 --:--:-- --:--:-- --:--:-- 50800
{"jobs": {"dev-demo2": {"regexpFilterExpression": "","triggered": true,"resolvedVariables": {"username": "jenkins","username_0": "jenkins","version": "1.1.1","version_0": "1.1.1"},"regexpFilterText": "","id": 58,"url": "queue/item/58/"}},"message": "Triggered jobs."
}

pipeline输出日志

Generic Cause
[Pipeline] Start of PipelineReceived:Contributing variables:username = jenkinsusername_0 = jenkinsversion = 1.1.1version_0 = 1.1.1[Pipeline] node
Running on Jenkins in /var/lib/jenkins/workspace/dev-demo
[Pipeline] {
[Pipeline] stage
[Pipeline] { (web-trigger)
[Pipeline] script
[Pipeline] {
[Pipeline] echo
1.1.1
[Pipeline] echo
jenkins
[Pipeline] }
[Pipeline] // script
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline
Finished: SUCCESS

示例-2 解析Header参数

在示例-1的基础上，配置Header参数

pipeline内容对应添加

echo "${header_name}"
echo "${header_id}"

curl命令模拟请求测试

$ curl --location --request GET "http://192.168.16.200:8080/generic-webhook-trigger/invoke?token=test-web-trigger&version=1.1.1&username=jenkins" --header 'header_name:admin' --header 'header_id:100' | python -m json.tool% Total    % Received % Xferd  Average Speed   Time    Time     Time  CurrentDload  Upload   Total   Spent    Left  Speed
100   338  100   338    0     0  57395      0 --:--:-- --:--:-- --:--:-- 67600
{"jobs": {"dev-demo2": {"regexpFilterExpression": "","triggered": true,"resolvedVariables": {"header_id": "100","header_id_0": "100","header_name": "admin","header_name_0": "admin","username": "jenkins","username_0": "jenkins","version": "1.1.1","version_0": "1.1.1"},"regexpFilterText": "","id": 64,"url": "queue/item/64/"}},"message": "Triggered jobs."
}

pipeline日志输出

Generic Cause
[Pipeline] Start of PipelineReceived:Contributing variables:header_id = 100header_id_0 = 100header_name = adminheader_name_0 = adminusername = jenkinsusername_0 = jenkinsversion = 1.1.1version_0 = 1.1.1[Pipeline] node
Running on Jenkins in /var/lib/jenkins/workspace/dev-demo2
[Pipeline] {
[Pipeline] stage
[Pipeline] { (web-trigger)
[Pipeline] script
[Pipeline] {
[Pipeline] echo
1.1.1
[Pipeline] echo
jenkins
[Pipeline] echo
admin
[Pipeline] echo
100
[Pipeline] }
[Pipeline] // script
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline
Finished: SUCCESS

示例-3 解析Post参数

配置Post参数

• Expression获取数据并赋值给Variable，
• 变量名称可以自定义，Expression根据数据格式和内容编写
  

配置token

配置调试日志

pipeline内容

pipeline {agent {label 'master'}stages {stage('web-trigger') {steps {script {echo "${devopsName}"}}}}
}

curl命令模拟请求测试

$ curl --location --request POST "http://192.168.16.200:8080/generic-webhook-trigger/invoke?token=test-web-trigger-post" \
--header 'Content-Type: application/json' \
--data-raw "{'name':'admin','id':'100','group':{'name':'jenkins','id':'101'}}" | python -m json.tool% Total    % Received % Xferd  Average Speed   Time    Time     Time  CurrentDload  Upload   Total   Spent    Left  Speed
100   260  100   195  100    65   2199    733 --:--:-- --:--:-- --:--:--  2954
{"jobs": {"dev-demo3": {"regexpFilterExpression": "","triggered": true,"resolvedVariables": {"devopsName": "jenkins"},"regexpFilterText": "","id": 72,"url": "queue/item/72/"}},"message": "Triggered jobs."
}

pipeline输出日志

Generic Cause
[Pipeline] Start of PipelineReceived:{'name':'admin','id':'100','group':{'name':'jenkins','id':'101'}}Contributing variables:devopsName = jenkins[Pipeline] node
Running on Jenkins in /var/lib/jenkins/workspace/dev-demo3
[Pipeline] { (hide)
[Pipeline] stage
[Pipeline] { (web-trigger)
[Pipeline] script
[Pipeline] {
[Pipeline] echo
jenkins
[Pipeline] }
[Pipeline] // script
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline
Finished: SUCCESS