如何通过Bitbucket仓库Webhook触发多分支参数化Jenkins Pipeline任务

一、通过共享库配置SCM轮询（替代Webhook） #

你用共享库且不想把流水线逻辑放在Bitbucket的Jenkinsfile里，那可以在共享库的流水线模板中加入SCM轮询逻辑，结合分支参数实现精准触发：

1. 封装分支提交检查逻辑 #

在共享库的vars目录下新建pollBitbucketBranch.groovy脚本，用来拉取指定分支的最新提交ID并和上次构建记录对比：

def call(String repoUrl, String branchName, String lastCommitId) {
    // 拉取指定分支的最新提交哈希
    def latestCommit = sh(
        script: "git ls-remote ${repoUrl} refs/heads/${branchName} | awk '{print \$1}'",
        returnStdout: true
    ).trim()
    
    // 判断是否有新提交
    if (latestCommit != lastCommitId) {
        echo "分支 ${branchName} 存在新提交，继续构建"
        return true
    } else {
        echo "分支 ${branchName} 无更新，终止构建"
        return false
    }
}

2. 在流水线模板中整合轮询逻辑 #

在共享库的流水线模板（比如vars/pipelineTemplate.groovy）里，加入定时触发、提交检查和构建逻辑：

def call(Map params) {
    def branchName = params.branchName
    def repoUrl = params.repoUrl
    // 获取上次构建记录的提交ID，首次构建设为空
    def lastCommitId = currentBuild.previousBuild ? currentBuild.previousBuild.buildVariables.lastCommitId : ""
    
    pipeline {
        agent any
        parameters {
            string(name: 'BRANCH_NAME', defaultValue: branchName, description: '目标构建分支')
        }
        triggers {
            // 配置定时轮询，示例为每5分钟检查一次，可按需调整
            cron('H/5 * * * *')
        }
        stages {
            stage('检查分支变更') {
                steps {
                    script {
                        def hasUpdate = pollBitbucketBranch(repoUrl, BRANCH_NAME, lastCommitId)
                        if (!hasUpdate) {
                            error "分支无更新，终止本次构建"
                        }
                        // 记录本次构建的最新提交ID，供下次轮询对比
                        env.LAST_COMMIT_ID = sh(
                            script: "git ls-remote ${repoUrl} refs/heads/${BRANCH_NAME} | awk '{print \$1}'",
                            returnStdout: true
                        ).trim()
                    }
                }
            }
            stage('克隆代码') {
                steps {
                    sh "git clone -b ${BRANCH_NAME} ${repoUrl} ."
                }
            }
            // 后续的构建、测试、部署等阶段...
        }
        post {
            always {
                // 在构建描述中记录分支和提交ID，方便排查
                script {
                    currentBuild.setDescription("分支: ${BRANCH_NAME} | 最新提交: ${env.LAST_COMMIT_ID}")
                }
            }
        }
    }
}

二、优化方案：全局Webhook+分支过滤 #

如果不想用定时轮询，也可以配置Bitbucket全局Webhook，再在流水线里做分支匹配过滤：

1. 在Bitbucket仓库配置一个全局Webhook，触发事件选「分支推送」，回调地址填Jenkins的/bitbucket-hook/（确保Jenkins已安装Bitbucket插件）
2. 在共享库流水线模板中添加分支验证逻辑：

def call(Map params) {
    pipeline {
        agent any
        parameters {
            string(name: 'BRANCH_NAME', description: '目标构建分支')
        }
        triggers {
            BitbucketTrigger()
        }
        stages {
            stage('验证触发分支') {
                steps {
                    script {
                        // 获取Webhook传递的触发分支
                        def triggerBranch = env.BITBUCKET_BRANCH ?: ""
                        if (triggerBranch != BRANCH_NAME) {
                            error "触发分支 ${triggerBranch} 与目标分支 ${BRANCH_NAME} 不匹配，终止构建"
                        }
                    }
                }
            }
            // 后续克隆、构建步骤...
        }
    }
}

这种方式下，Bitbucket有分支推送时会触发所有基于该模板的任务，但只有分支匹配的任务会继续执行，其余直接终止。

三、注意事项 #

• 确保Jenkins节点能正常访问Bitbucket仓库，git ls-remote命令可执行
• 定时轮询的cron表达式按需调整，避免过于频繁占用资源
• Webhook方案需确保Jenkins的Bitbucket插件版本兼容，且Webhook的密钥验证（若开启）配置正确

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