Azure DevOps同项目跨仓库模板引用变量替换失败求助

问题现象 #

在多仓库流水线中，所有仓库通过resources块的ref: refs/tags/$(variableName)按标签引用，其中两个存放Terraform代码的仓库能正常按变量值检出，但用于加载流水线模板的仓库在使用- template: templateName.yml@cicd-templates调用模板时，出现以下错误：

/azure-pipelines.yml: Could not get the latest source version for repository cicd-templates hosted on Azure Repos using ref refs/tags/$(cicd-templates-version)

改用模板表达式语法ref: refs/tags/${{ variables.cicd-templates-version }}后，变量未被解析，错误变为：

/azure-pipelines.yml: Could not get the latest source version for repository cicd-templates hosted on Azure Repos using ref refs/tags/

直接写固定标签（如ref: refs/tags/0.0.1）则完全正常。

原因分析 #

这不是Azure DevOps的bug，而是模板解析时机与变量加载时机的冲突：

• 流水线模板（template@repo）的加载发生在流水线初始化阶段，此时系统需要确定模板仓库的ref来拉取模板文件，这个阶段早于变量模板（yml-config/variables.yml）的加载完成时间。
• 存放Terraform代码的仓库仅在job执行阶段被拉取，此时变量已经完成解析，所以$(variableName)能正常生效。

解决办法 #

方法1：使用变量组存储版本变量 #

将版本变量移至Azure DevOps变量组，变量组的变量在流水线初始化阶段即可被解析：

1. 在Azure DevOps项目中创建变量组（如VersionVariables），添加cicd-templates-version、tf-modules-version等版本变量。
2. 修改主流水线的变量引用：

   variables:
   - group: VersionVariables
   - template: yml-config/variables.yml # 保留其他非版本变量
   

3. 更新resources块的ref为模板表达式语法：

   resources:
     repositories:
     - repository: cicd-templates
       type: git
       name: myProject/cicd-templates
       ref: refs/tags/${{ variables.cicd-templates-version }}
   

方法2：将版本变量直接定义在主流水线 #

把版本变量直接写在主流水线的variables块中，确保初始化阶段能被模板解析器获取：

variables:
- name: cicd-templates-version
  value: '0.0.1'
- name: tf-modules-version
  value: '0.0.1'
- name: tf-templates-version
  value: '0.0.1'
- template: yml-config/variables.yml

resources块同样使用${{ variables.cicd-templates-version }}作为ref值。

方法3：手动拉取模板仓库（变通方案） #

放弃template@repo语法，通过checkout步骤在job中拉取模板仓库，再引用本地模板：

trigger:
  - none

variables:
- template: yml-config/variables.yml

resources:
  # 移除cicd-templates的resources定义，或保留但仅用于拉取代码而非模板
  repositories:
  - repository: tf-templates
    type: git
    name: myProject/tf-templates
    ref: refs/tags/$(tf-templates-version)

  - repository: tf-modules
    type: git
    name: myProject/tf-modules
    ref: refs/tags/$(tf-modules-version)

stages:
- stage: PrepareTemplates
  jobs:
  - job: CheckoutTemplates
    steps:
    - checkout: git://myProject/cicd-templates@refs/tags/$(cicd-templates-version)
      path: 'templates/cicd-templates'

- stage: RunBackendSetup
  dependsOn: PrepareTemplates
  jobs:
  - template: ../templates/cicd-templates/yaml/tf-backend-setup.yml
    parameters:
      serviceConnectionName: $(serviceConnectionName)
      subId: $(subscription-id)

# 其他stage同理调整模板引用路径

验证 #

使用方法1或方法2后，流水线初始化阶段能正确解析版本变量，模板仓库可正常拉取模板文件，不会再出现ref解析错误。

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