如何不使用Gitlab Webhook，通过Jenkinsfile触发PR创建时的Jenkins任务

前置要求 #

• Jenkins已安装GitLab Plugin和Pipeline Plugin
• Jenkins服务器能访问GitLab API，且已配置GitLab个人访问令牌（权限需包含read_api、read_repository）

步骤1：配置Jenkins与GitLab的全局连接 #

1. 进入Jenkins「系统管理」→「系统配置」
2. 找到「GitLab」板块，点击「添加GitLab服务器」
3. 填入GitLab服务器地址，粘贴个人访问令牌，点击「测试连接」确认成功
4. 保存配置

步骤2：创建并配置Jenkins流水线任务 #

1. 新建「流水线」类型任务
2. 到「触发器」区域，勾选「Poll SCM」，设置轮询周期（比如H/5 * * * *，每5分钟检查一次，可按需调整）
3. 「流水线」区域选择「Pipeline script from SCM」，填写你的GitLab仓库地址，选择对应GitLab凭据
4. 分支指定为refs/merge-requests/*/head（仅监听PR分支）或**（全分支监听）
5. 保存任务

步骤3：Jenkinsfile中编写PR触发逻辑 #

在仓库根目录的Jenkinsfile中添加以下逻辑，确保仅PR触发时执行流水线：

pipeline {
    agent any
    triggers {
        pollSCM('H/5 * * * *')
    }
    stages {
        stage('Validate PR Trigger') {
            steps {
                script {
                    // 仅PR触发时继续执行
                    if (!env.CHANGE_ID) {
                        echo "非PR触发，终止流水线"
                        currentBuild.result = 'ABORTED'
                        return
                    }
                    echo "触发自PR #${env.CHANGE_ID}"
                }
            }
        }
        stage('Build & Test') {
            when {
                expression { env.CHANGE_ID != null }
            }
            steps {
                echo "开始构建PR #${env.CHANGE_ID}"
                // 替换为你的构建命令，比如`npm install && npm test`
            }
        }
    }
    post {
        success {
            script {
                if (env.CHANGE_ID) {
                    // 可选：向GitLab PR同步构建成功状态
                    gitlabCommitStatus(name: 'Jenkins Build', state: 'success')
                }
            }
        }
        failure {
            script {
                if (env.CHANGE_ID) {
                    gitlabCommitStatus(name: 'Jenkins Build', state: 'failed')
                }
            }
        }
    }
}

排查之前的GitLab流水线错误 #

你之前按教程操作出现GitLab流水线错误，原因是教程默认用了Webhook触发模式，而你要跳过Webhook，需要做以下清理：

• 关闭GitLab仓库「设置」→「CI/CD」→「流水线」中的Jenkins集成配置
• 确保Jenkins任务未勾选「GitLab触发的构建」选项，仅保留「Poll SCM」
• 检查GitLab个人访问令牌的权限，确认能读取PR相关信息

关键提示 #

• 轮询周期根据项目需求调整，过短会增加服务器负载，过长会导致触发延迟
• env.CHANGE_ID是GitLab插件自动注入的环境变量，仅PR触发的构建会有值
• 如果需要仅在PR创建/重新打开时触发，可在Jenkinsfile中通过GitLab API查询PR状态后添加判断逻辑

内容的提问来源于stack exchange，提问作者Shermy