Azure Pipelines中如何引用仓库资源信息并传递至模板？

问题原因分析 #

1. 数组语法错误：你在additionalData中直接将数组类型的parameters.resourceTypes作为单个元素添加，导致数组嵌套结构，进而引发表达式解析器误判resources为未知名称。
2. 表达式类型误用：$(...)是运行时变量，在模板参数传递的编译阶段不会被解析，因此会被当作字面字符串直接传递；而${{...}}是编译时表达式，需确保语法完全正确才能正常解析根级别的resources对象。

解决方案 #

方案1：用concat函数合并扁平数组（推荐） #

使用Azure Pipelines内置的concat函数，将parameters.resourceTypes和仓库ref合并为一个结构正确的扁平数组：

parameters:
  - name: resourceTypes
    ...
  - name: deployEXE
    ...

trigger: ...

resources:
  pipelines:
  - pipeline: ...
  repositories:
  - repository: TestData
    type: git
    name: testdata
    ref: refs/heads/master

extends:
  template: pipeline-template.yml
  parameters:
    jobName: 'Nightly Testing'
    testHost: 'VM Name'
    testTask: '.'
    deployExe: ${{parameters.deployExe}}
    checkoutTemplate: checkout-steps.yml
    postTestTemplate: post-test-steps.yml
    agentPool: test-agents
    agentName: VTMAGENT
    usesTemplate:
      repositories:
       - TestData
    hasOtherOutput: true
    timeoutInMinutes: 180
    # 用concat合并数组，避免嵌套结构
    additionalData: ${{concat(parameters.resourceTypes, [resources.repositories.TestData.ref])}}

方案2：通过中间变量传递 #

先在根YAML中定义变量存储仓库ref，再将变量传递到模板参数：

parameters:
  - name: resourceTypes
    ...
  - name: deployEXE
    ...

trigger: ...

# 定义变量存储仓库分支ref
variables:
  testDataBranchRef: ${{resources.repositories.TestData.ref}}

resources:
  pipelines:
  - pipeline: ...
  repositories:
  - repository: TestData
    type: git
    name: testdata
    ref: refs/heads/master

extends:
  template: pipeline-template.yml
  parameters:
    # 其他参数保持不变
    additionalData: 
      - ${{parameters.resourceTypes}}
      - ${{variables.testDataBranchRef}}

注意：如果parameters.resourceTypes本身是数组，这种写法会导致additionalData成为嵌套数组（如[[item1, item2], "refs/heads/master"]），此时仍建议使用方案1的concat函数确保数组结构扁平。

方案3：模板内直接引用资源 #

如果模板pipeline-template.yml中需要使用该仓库的ref，可直接在模板内通过编译时表达式引用，无需在根YAML传递参数：

在模板文件中添加：

# pipeline-template.yml
steps:
  - script: git pull origin ${{resources.repositories.TestData.ref}}
    displayName: '拉取TestData指定分支'

前提是根YAML中已定义TestData仓库资源，模板可直接访问根级别的resources对象。

关键注意事项 #

• resources需定义在根YAML的根级别（与extends同级），编译阶段可正常被表达式解析。
• 编译时表达式${{...}}用于传递静态/预定义的资源信息，运行时变量$(...)仅适用于运行时动态获取的值，不要在模板参数传递场景混用。

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