如何配置Jenkins触发Bitbucket推送任意分支的构建？

Jenkins任务配置步骤 #

1. 开启参数化构建

   • 进入目标Jenkins任务的配置页面，勾选「参数化构建过程」，添加一个字符串参数，命名为BRANCH_NAME（名字可自定义，后续配置需保持统一）。

2. 动态设置分支拉取规则

   • 在「源码管理」的Git配置中，把「分支指定符」从固定的dev1修改为*/${BRANCH_NAME}，这样构建时会根据传入的参数自动拉取对应分支的代码。

3. 配置Generic Webhook Trigger插件

   • 找到「构建触发器」区域，勾选「Generic Webhook Trigger」。
   • 进入「Post content parameters」，添加一个参数：
     • Key填branch，Value表达式填$.ref.split('/')[2]（Bitbucket推送的Webhook中，分支信息存放在ref字段，格式为refs/heads/分支名，这个表达式可以直接提取出分支名称）。
     • 勾选「This parameter is required」，确保只有成功提取到分支参数时才触发构建。
   • 在「Token」栏设置专属触发令牌（比如jenkins-bitbucket-trigger），后续Bitbucket配置要用到这个令牌。
   • 进入「Parameter mappings」，将提取到的branch参数映射到之前创建的BRANCH_NAME参数，让分支参数能传递到源码拉取环节。
   • 可在「Cause」栏自定义触发显示信息，比如Bitbucket推送触发：分支 $branch，方便在构建历史里识别触发原因。

Bitbucket Webhook配置步骤 #

1. 打开你的Bitbucket仓库，进入「Settings」>「Webhooks」页面，点击「Create webhook」。
2. 填写基本信息：
   • Title随便填，比如「Jenkins全分支构建触发器」。
   • URL填写Jenkins的触发地址：http://你的Jenkins服务地址/generic-webhook-trigger/invoke?token=你刚才设置的令牌。
3. 选择触发条件：在「Triggers」里勾选「Repository push」，确保只有代码推送操作才触发Webhook。
4. 其他选项保持默认，点击保存即可。

验证配置 #

随便新建一个分支（比如test-dev-001）并推送代码，查看Jenkins是否自动触发构建，且构建拉取的是刚推送的分支代码，确认配置生效。

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