TeamCity配置PR目标分支变更触发构建的方案咨询

1. 确认VCS根的PR配置正确 #

首先确保你的Bitbucket Server VCS根已开启PR支持：

• 进入TeamCity项目的VCS根设置，选择Bitbucket Server类型
• 勾选「Enable support for pull requests」
• 在「Pull request source branch filter」中设置为+:refs/heads/*（允许所有源分支的PR）
• 在「Pull request target branch filter」中设置需要监听的目标分支，比如+:refs/heads/main、+:refs/heads/develop
• 分支规范中保留+:pull-requests/*/merge，确保TeamCity能获取PR的合并预览分支

2. 配置VCS触发器监听目标分支变更 #

在项目的构建配置中修改或添加VCS触发器：

• 新建VCS触发器，勾选「Trigger on changes in watched branches」
• 在「Branch filter」中设置为+:pull-requests/*/merge（指定触发PR合并分支的构建）
• 在「Trigger rules」中添加规则：+:refs/heads/<你的目标分支名>（比如+:refs/heads/main）
  • 该规则作用：当目标分支（如main）有代码变更时，触发所有匹配pull-requests/*/merge的分支（即所有打开的PR合并预览分支）的构建

3. 验证触发器行为 #

• 手动向目标分支提交一个小变更（比如修改README）
• 查看TeamCity的构建队列，确认所有以该分支为目标的打开PR是否触发了新构建
• 如果未触发，检查VCS根的「Test connection」是否正常，确认TeamCity能拉取到Bitbucket Server的PR和分支变更

备选方案：使用Bitbucket Webhook触发（更精准） #

如果上述配置未生效，可通过Webhook实现：

• 在Bitbucket Server的目标分支所在仓库中添加Webhook：
  • 触发条件选择「Repository push」，仅勾选你的目标分支
  • Webhook URL设置为TeamCity的触发API：http://<你的TeamCity地址>/app/rest/buildQueue
  • 请求方法选POST，Body内容指定触发所有以该分支为目标的PR构建：

    {
      "buildType": { "id": "<你的构建配置ID>" },
      "branchFilter": "+:pull-requests/*/merge:(target:<你的目标分支名>)"
    }
    

• 配置TeamCity的API访问凭证，确保Bitbucket能正常调用API

注意：确保TeamCity的用户有足够权限触发构建，且Bitbucket的Webhook能访问到TeamCity服务器。

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