如何配置Jenkins仅在Bitbucket的master分支收到提交时触发构建

配置错误的常见原因 #

• Bitbucket侧webhook未配置分支过滤：大部分情况是你在webhook触发规则里没有限制分支，勾选了全部分支的推送事件，导致所有分支的提交都会向Jenkins发送触发请求。
• Jenkins侧构建分支规则配置错误：如果你在「源码管理-Git」的「待构建分支」栏填了**或者留空，Jenkins收到任何触发请求都会默认拉取master分支执行构建，就会出现你遇到的任意分支提交都触发master流水线的问题。
• Bitbucket插件分支过滤未开启：Jenkins 2.303.1对应的部分旧版Bitbucket插件默认关闭分支过滤功能，你即使配置了分支规则也不会生效。
• 多分支流水线未配置分支过滤规则：如果用的是多分支流水线，没有设置仅包含master分支的过滤规则的话，其他分支的提交也会触发master分支的构建。

修正步骤 #

1. 调整Bitbucket webhook配置：进入对应仓库的设置页，找到已配置的Jenkins webhook，触发事件仅勾选「仓库推送」和「拉取请求合并」，分支过滤规则设置为仅匹配master分支。
2. 调整Jenkins流水线配置：
   • 单分支流水线：进入配置页，「源码管理-Git」模块的「待构建分支」填写*/master；再到「构建触发器」模块，找到Bitbucket触发选项，开启分支名称过滤，仅允许master分支的事件触发构建。
   • 多分支流水线：进入配置页的「分支源-Git」模块，添加「通配符名称过滤」行为，包含分支填master，排除分支填*。
3. 插件版本检查：如果上述配置都正确还是失效，把Bitbucket插件升级到2.2.3及以上稳定版，2.303.1版本Jenkins兼容的旧版插件存在分支过滤失效的已知bug。
4. 配置验证：调整完成后，向非master分支提交测试代码确认不会触发构建，向master分支提交或者合并PR确认能正常触发构建。

内容的提问来源于stack exchange，提问作者M Hamza Razzaq