Azure Pipelines模板中resources.repositories.ref变量使用报错求助

Azure Pipelines中，resources.repositories的解析发生在模板编译阶段，这个阶段早于管道运行时变量（比如$(Build.SourceBranchName)）的注入时机；同时子模板的上下文无法直接访问管道级别的编译时变量（${{ variables['Build.SourceBranchName'] }}），这就是你遇到两类错误的核心原因：

• 子模板使用${{ variables['Build.SourceBranchName'] }}：编译时子模板上下文不存在该变量，导致YAML结构解析失败，抛出"Expected a scalar,a sequence,or a mapping"错误
• 子模板使用$(Build.SourceBranchName)：resources解析时运行时变量尚未赋值，管道无法识别该引用，因此报"Could not get the latest source version..."错误

解决思路是将分支名从父模板（或主管道）作为参数传递给子模板——参数在模板编译阶段是可见且可解析的，能完美适配resources的解析时机要求。

步骤1：修改子模板，新增分支引用参数 #

在子模板中添加branchRef参数，用它来设置resources.repositories.ref的值：

parameters:
  - name: buildConfiguration
    type: string
    values: [Debug, Release]

  - name: api
    type: string

  - name: solutionLocation
    type: string

  # 新增分支引用参数，用于接收外部传递的分支名
  - name: branchRef
    type: string

resources:
  repositories:
    - repository: xxxx-apis-parent-templates
      name: xxxx-dotnet-solution
      type: git
      ref: ${{ parameters.branchRef }}  # 使用参数值设置分支引用

extends:
  template: .az-devops-cicd/templates/aks.yaml@xxxx-apis-parent-templates
  parameters:
    solutionLocation: ${{ parameters.solutionLocation }}
    projectRepository: xxxxxx-apis
    projectBaseDir: ${{ parameters.solutionLocation }}/${{ parameters.api }}/
    projectName: XXXX.${{ parameters.solutionLocation }}.Apis.${{ parameters.api }}
    buildConfiguration: ${{ parameters.buildConfiguration }}

步骤2：在调用方传递分支参数 #

在主管道或父模板调用该子模板时，通过编译时变量${{ variables['Build.SourceBranchName'] }}（或直接指定固定分支名）传递branchRef参数：

主管道调用示例 #

trigger:
  branches:
    include:
      - main
      - develop

variables:
  buildConfiguration: 'Release'

jobs:
  - template: path/to/your/sub-template.yaml
    parameters:
      buildConfiguration: ${{ variables.buildConfiguration }}
      api: 'YourApiName'
      solutionLocation: 'YourSolutionPath'
      branchRef: ${{ variables['Build.SourceBranchName'] }}  # 传递编译时分支变量

父模板调用示例 #

如果是父模板嵌套调用子模板，先在父模板中定义branchRef参数，再传递给子模板：

# 父模板内容
parameters:
  - name: branchRef
    type: string
  # 其他父模板参数...

jobs:
  - template: path/to/your/sub-template.yaml
    parameters:
      # 其他子模板参数...
      branchRef: ${{ parameters.branchRef }}

之后在主管道调用父模板时传入branchRef: ${{ variables['Build.SourceBranchName'] }}即可。

通过参数传递分支名后，模板编译阶段就能拿到明确的分支引用值，既解决了子模板无法访问管道变量的上下文问题，又保证了resources在编译时能正确解析到对应分支。

内容的提问来源于stack exchange，提问作者Matías Fidemraizer