在 Jenkins 2.528.3 版本中，实现 GitLab 代码推送（Push）后自动触发构建，主要依赖于GitLab Plugin或Generic Webhook Trigger Plugin。以下是两种主流方法的详细配置指南，帮助构建高效的自动化流水线。
核心配置概览
| 自动构建触发方案 | 核心特点 |
|---|---|
| GitLab Plugin (官方集成) | 配置简单，支持构建状态回传 GitLab |
| Generic Webhook Trigger Plugin | 配置灵活，支持多源事件与复杂触发逻辑 |
方法一：使用 GitLab Plugin（官方集成）
这是最直接、与 GitLab 官方集成度最高的方法，不仅能触发构建，还能将 Jenkins 的构建状态回传到 GitLab 的提交或合并请求中，提供完整的 CI/CD 反馈。
1. 安装并配置 GitLab Plugin
（1）安装插件
登录 Jenkins，进入Manage Jenkins>Manage Plugins
切换至Available标签页，搜索GitLab Plugin并安装
安装完成后重启 Jenkins 使插件生效
（2）配置 GitLab 凭证
进入Jenkins>Credentials>System>Global credentials (unrestricted)
点击Add Credentials，类型选择GitLab API token
粘贴从 GitLab 获取的 API Token，填写 ID 和描述后保存
（3）配置 GitLab 服务器连接
进入Manage Jenkins>Configure System
找到GitLab配置区域，点击Add GitLab Server
填写配置项：
Name：自定义服务器名称
GitLab URL：GitLab 实例的访问地址（如
https://gitlab.example.com）Credentials：选择上一步创建的 GitLab API Token 凭证
勾选Enable authentication for 'project' end-point
点击Test Connection，验证连接成功后保存
2. 配置 Jenkins 项目
以Freestyle project为例，配置步骤如下：
新建或进入目标 Jenkins 项目，点击Configure
源码管理配置：
选择Git，填写 GitLab 仓库地址
选择对应凭证（如 SSH 密钥或用户名密码）
构建触发器配置：
勾选Build when a change is pushed to GitLab
可选监听事件类型（如Push events、Merge Request events等）
点击Advanced可配置触发分支、Secret Token 等高级选项
构建后操作配置：
点击Add post-build action，选择Publish build status to GitLab
按需配置状态回传的详细参数（如失败时是否回传）
保存项目配置
3. 配置 GitLab 项目集成（官方推荐）
进入 GitLab 目标项目，点击Settings>Integrations
在集成列表中选择Jenkins，激活集成开关
填写配置项：
Jenkins server URL：Jenkins 实例的访问地址（如
https://jenkins.example.com）Project name：Jenkins 项目名称（注意使用下划线替代空格）
点击Test settings and save，验证并保存配置
4. 配置 GitLab Webhook（备选方案）
若无法通过 GitLab 集成功能直接配置，可使用 Webhook 方式：
在 Jenkins 项目的构建触发器区域，复制Secret Token
进入 GitLab 项目，点击Settings>Webhooks
填写配置项：
URL：Jenkins 提供的 Webhook 地址（格式：
https://jenkins.example.com/project/<项目名>）Secret token：粘贴从 Jenkins 复制的 Secret Token
Trigger：勾选Push events
点击Add webhook保存
注意事项：若 GitLab 提示本地网络请求被禁止，需由管理员进入Admin Area>Settings>Network，在Outbound requests中允许本地网络请求
方法二：使用 Generic Webhook Trigger Plugin（更灵活）
此方法通过 Jenkins 的 Webhook 接收 GitLab 事件通知，配置灵活，支持复杂触发逻辑，需编写 Pipeline 脚本。
1. 安装插件
进入Manage Jenkins>Manage Plugins
在Available标签页搜索Generic Webhook Trigger并安装
重启 Jenkins 生效
2. 配置 Jenkins Pipeline
在 Jenkinsfile 中通过properties指令配置触发器，核心是使用GenericTrigger类定义触发规则。
properties([
pipelineTriggers([
[
$class: 'GenericTrigger',
// 定义从 GitLab Webhook 中提取的变量
genericVariables: [
[key: 'ref', value: '$.ref', expressionType: 'jsonPath'],
[key: 'projectName', value: '$.project.name', expressionType: 'jsonPath']
],
// Webhook 唯一标识 Token
token: 'jenkins-gitlab-token',
// 打印 Webhook 传输内容（调试用）
printPostContent: true,
// 打印提取的变量（调试用）
printContributedVariables: true,
// 可选：设置触发条件（如仅特定分支触发）
regexpFilterText: '$ref',
regexpFilterExpression: 'refs/heads/main'
]
])
])
pipeline {
agent any
stages {
stage('Build') {
steps {
echo "Triggered by GitLab push event"
echo "Project: ${projectName}"
echo "Branch: ${ref}"
// 此处添加构建逻辑（如拉取代码、编译、打包等）
sh 'git pull'
}
}
}
}
3. 配置 GitLab Webhook
进入 GitLab 目标项目，点击Settings>Webhooks
填写配置项：
URL：Generic Webhook 触发地址（格式：
https://jenkins.example.com/generic-webhook-trigger/invoke?token=jenkins-gitlab-token）Content type：选择application/json
Trigger：勾选Push events
Secret token：填写与 Jenkins Pipeline 中一致的 token 值（
jenkins-gitlab-token）
点击Add webhook保存
常见问题与注意事项
集成问题排查
连接失败 (Connection failed)
检查 Jenkins 与 GitLab 的网络连通性
验证 GitLab API Token 权限（需至少api权限）
确认 Jenkins 配置中勾选了Enable authentication for 'project' end-point
无法连接到 CI 服务器
确认 Jenkins 项目已配置Publish build status to GitLab构建后操作
检查 GitLab 集成中的 Jenkins 服务器 URL 是否正确
Webhook 超时
若 Jenkins 构建耗时较长，进入 GitLabAdmin Area>Settings>Network
在Webhook settings中增加Timeout时间（单位：秒）
测试与验证
无论采用哪种方法，配置完成后需验证触发效果：
进入 GitLab Webhook 配置页面，点击Test按钮
选择Push events类型，发送测试请求
若返回Hook successfully executed.，则 Webhook 配置正常
查看 Jenkins 项目的构建历史，确认是否触发自动构建
)
