Azure Pipelines中跨仓库为源码分支计算并应用Git Tag

背景 #

我们有基础设施（Infra）和源码两个仓库，当前Pipeline仅支持对Infra分支计算Git版本并打Tag，需要扩展到源码分支。使用GitVersion时遇到警告：检测到多个源分支，默认选择dev分支，可能导致提交计数错误。

现有Pipeline任务 #

版本计算任务 #

- task: gitversion/setup@0
  displayName: Install GitVersion
  inputs:
    versionSpec: '5.x'

- task: gitversion/execute@0
  displayName: Determine Version
  inputs:
    useConfigFile: true
    configFilePath: 'global/GitVersion.yml'

标签应用任务 #

- task: Bash@3
  inputs:
    targetType: 'inline'
    script: | 
      git config --global user.email "$(Build.RequestedForEmail)"
      git config --global user.name "$(Build.RequestedFor)"
      if [ $(git tag -l "$(GitVersion.SemVer)") ]; then
        echo "Tag $(GitVersion.SemVer) already exists. Skipping Tagging."
      else
        git tag $(GitVersion.SemVer) -m "release build"
        git push origin $(GitVersion.SemVer) --force
      fi

触发的警告信息 #

检测到多个源分支，将选择第一个分支(dev)。
这可能导致提交计数错误。
可选分支：
dev, release/1.0.1, releases/1.0.2, releases/1.0.0, main

解决步骤 #

1. 明确指定GitVersion目标分支 #

在gitversion/execute@0任务中添加targetBranch参数，直接绑定当前构建的分支，避免工具自动选择分支：

- task: gitversion/execute@0
  displayName: Determine Version
  inputs:
    useConfigFile: true
    configFilePath: 'global/GitVersion.yml'
    targetBranch: '$(Build.SourceBranchName)'

$(Build.SourceBranchName)是Azure Pipeline内置变量，会自动获取当前触发构建的分支名称，确保版本计算基于正确的分支。

2. 分离多仓库的Pipeline逻辑 #

针对Infra和源码仓库分别配置独立的Pipeline，或在现有Pipeline中通过条件判断区分仓库：

• 使用$(Build.Repository.Name)变量判断当前处理的仓库，加载对应的GitVersion配置或分支规则，避免两个仓库的分支互相干扰。

3. 优化GitVersion配置文件 #

在GitVersion.yml中明确分支优先级和版本规则，减少多分支识别冲突：

branches:
  main:
    mode: ContinuousDelivery
    increment: Patch
    trackMergeTarget: false
  dev:
    mode: ContinuousDeployment
    tag: 'beta'
    increment: Minor
    trackMergeTarget: true
  release/*:
    mode: ContinuousDelivery
    tag: 'rc'
    increment: Patch
    trackMergeTarget: false
  releases/*:
    mode: ContinuousDelivery
    tag: 'rc'
    increment: Patch
    trackMergeTarget: false

添加releases/*分支规则，匹配警告中出现的分支格式，确保GitVersion能正确识别所有发布分支。

4. 修正标签推送逻辑 #

原脚本中的--force参数存在覆盖已有标签的风险，建议移除，保留标签存在性检查即可：

- task: Bash@3
  inputs:
    targetType: 'inline'
    script: | 
      git config --global user.email "$(Build.RequestedForEmail)"
      git config --global user.name "$(Build.RequestedFor)"
      TAG=$(GitVersion.SemVer)
      if git tag -l "$TAG"; then
        echo "Tag $TAG already exists. Skipping Tagging."
      else
        git tag "$TAG" -m "release build"
        git push origin "$TAG"
      fi

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