Azure DevOps编译时变量引用失效问题咨询

Azure DevOps里$(varname)是运行时变量，用编译时语法${{ variables.myVar }}却出问题了。流水线采用主文件+环境模板+部署模板的三层结构：主文件定义myVar值为'one'，环境模板传递参数时引用这个编译时变量，结果报错说参数值为空，不符合可选值要求。

三个文件内容如下：
azure-pipeline.yml

variables:
  - name: myVar
    value: 'one'

stages:
  # Deploy Dev
  - template: ./azure-pipeline-dev.yml
    

azure-pipeline-dev.yml

stages:
  - template: ./deploy.yml
    parameters: 
      myParam: ${{ variables.myVar }}

deploy.yml

parameters:
  - name: myParam
    type: string
    values:
      - one
      - two

报错信息：

/azure-pipeline-dev.yml 参数'myParam'的值''不是有效值。

报错原因 #

Azure DevOps的模板编译有作用域隔离规则：二级模板azure-pipeline-dev.yml的编译作用域里找不到myVar——主文件定义的变量不会自动流入二级模板的编译环境。编译时变量是模板本地解析的，跨模板引用必须手动显式传递。

解决办法 #

办法1：通过模板参数层层传递 #

给二级模板添加参数，让主文件把变量值传递过去，再中转给部署模板：

1. 修改主文件azure-pipeline.yml，调用二级模板时传值：

variables:
  - name: myVar
    value: 'one'

stages:
  # Deploy Dev
  - template: ./azure-pipeline-dev.yml
    parameters:
      myVarValue: ${{ variables.myVar }}

2. 更新azure-pipeline-dev.yml，定义参数接收值，再传给部署模板：

parameters:
  - name: myVarValue
    type: string

stages:
  - template: ./deploy.yml
    parameters: 
      myParam: ${{ parameters.myVarValue }}

办法2：跳过中转模板直接传参 #

如果azure-pipeline-dev.yml仅作为中转层，可直接在主文件里调用部署模板并传参：

variables:
  - name: myVar
    value: 'one'

stages:
  # Deploy Dev
  - template: ./deploy.yml
    parameters:
      myParam: ${{ variables.myVar }}

办法3：使用全局变量（不推荐） #

若需要变量在所有模板中全局可用，可将变量移至库变量组，或在主文件用简化格式定义（variables: { myVar: 'one' }），但这种方式灵活性差，不建议随意使用。

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