Azure DevOps YAML管道中GitVersion如何使用额外仓库分支？

方案一：使用GitTools任务（推荐） #

首先确保管道已完成两个仓库的检出：

steps:
- checkout: self  # 检出存放YAML的主仓库
- checkout: contoso  # 检出后端代码所在的contoso仓库（默认分支master）

然后配置GitVersion任务时，指定额外仓库的检出路径，让GitVersion直接读取该仓库的Git分支信息：

- task: GitVersion@5
  displayName: '基于contoso仓库计算版本号'
  inputs:
    repositoryPath: '$(Build.SourcesDirectory)/contoso'  # 指向contoso仓库的本地检出目录
    updateAssemblyInfo: true  # 按需开启，用于更新程序集版本信息

指定repositoryPath后，GitVersion会切换到该目录执行分析，自动读取contoso仓库的master分支信息，而非默认的主仓库分支。

方案二：使用PowerShell执行dotnet-gitversion #

如果需要更灵活的版本变量处理，可通过PowerShell切换到contoso仓库目录执行命令：

steps:
- checkout: self
- checkout: contoso

- pwsh: |
    # 按需安装dotnet-gitversion工具（若代理未预装）
    dotnet tool install --global GitVersion.Tool --version 5.12.0  # 替换为你需要的版本号
    # 切换到contoso仓库目录
    cd $(Build.SourcesDirectory)/contoso
    # 执行GitVersion并解析输出
    $versionData = dotnet-gitversion /output json | ConvertFrom-Json
    # 将版本信息设置为管道全局变量，供后续步骤使用
    Write-Host "##vso[task.setvariable variable=GitVersion.SemVer;]$($versionData.SemVer)"
    Write-Host "##vso[task.setvariable variable=GitVersion.FullSemVer;]$($versionData.FullSemVer)"
    # 验证输出
    Write-Host "生成的版本号：$($versionData.SemVer)"
  displayName: '通过PowerShell计算contoso仓库版本号'

该方法通过切换工作目录强制GitVersion读取contoso仓库的分支数据，同时可自定义提取需要的版本字段注入到管道中。

注意事项 #

• 若checkout时为contoso仓库指定了path参数，需同步修改上述代码中的目录路径
• 确保GitVersion工具版本与项目兼容，避免出现解析异常

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