Azure DevOps YAML动态阶段名称为空问题求助

我参照微软官方文档的示例，将名称传入stages模板并用作阶段名称变量，但该名称每次都显示为空。我尝试使用$(environment.uat)$(region.uk)，但生成的阶段名是stage_$(environment.uat)$(region.uk)Deploy。以下是调用方与模板的代码示例：

调用方代码 #

- template: "yaml-templates/stages-terraform-apply-deploy.yaml/@terraform-modules"
parameters:
  name: ${{variables.environment.uat}}${{variables.region.uk}}Deploy
  ...omited...

模板代码 #

parameters:
  backendAzureRmStorageAccountName: null
  azureSubscription: null
  workingDirectory: ci/terraform
  varsFile: null
  tfEnvironment: null
  region: null
  appName: null
  packagePath: null
  name: ""
  dependsOn: null

stages:
  - stage: stage_${{ parameters.name}}Deploy
   
    jobs:
      - deployment: Terraform
        displayName: Azure ${{parameters.tfEnvironment}} ${{parameters.region}}
        environment: ${{parameters.tfEnvironment}}
        strategy:
          runOnce:
            deploy:
              steps:
                - download: current
                  artifact: Package

                - checkout: terraform-modules
                - checkout: self

                - template: "terraform-plan-apply.yaml/@terraform-modules"
                  parameters:
                    workingDirectory: ${{parameters.workingDirectory}}
                    azureSubscription: ${{parameters.azureSubscription}}
                    backendAzureRmStorageAccountName: ${{parameters.backendAzureRmStorageAccountName}}
                environment: ${{parameters.tfEnvironment}}
                varsFile: ${{parameters.varsFile}}

请问我哪里操作有误？

错误点1：嵌套变量引用语法错误 #

Azure DevOps YAML中，对象类型的嵌套变量不能直接用${{variables.environment.uat}}引用，这种写法会被解析为普通变量而非嵌套属性，导致无法正确取值，最终传入模板的name参数为空。正确的嵌套变量引用方式是${{ variables.environment['uat'] }}或${{ variables['environment.uat'] }}。

错误点2：阶段名称重复拼接后缀 #

模板中阶段名称写为stage_${{ parameters.name}}Deploy，但调用方的name参数已经包含Deploy后缀（${{...}}Deploy），会导致最终阶段名变成stage_xxxDeployDeploy，属于冗余拼接。

错误点3：子模板参数缩进错误 #

模板步骤中，调用terraform-plan-apply.yaml子模板后，environment和varsFile没有缩进在parameters块内，会被视为独立的步骤配置，属于语法错误，可能导致流水线解析失败。

修正后的代码 #

修正后的调用方 #

- template: "yaml-templates/stages-terraform-apply-deploy.yaml/@terraform-modules"
parameters:
  # 使用正确的嵌套变量引用语法
  name: ${{ variables.environment['uat'] }}${{ variables.region['uk'] }}Deploy
  ...omited...

修正后的模板 #

parameters:
  backendAzureRmStorageAccountName: null
  azureSubscription: null
  workingDirectory: ci/terraform
  varsFile: null
  tfEnvironment: null
  region: null
  appName: null
  packagePath: null
  name: ""
  dependsOn: null

stages:
  # 去掉重复的Deploy后缀
  - stage: stage_${{ parameters.name }}
   
    jobs:
      - deployment: Terraform
        displayName: Azure ${{parameters.tfEnvironment}} ${{parameters.region}}
        environment: ${{parameters.tfEnvironment}}
        strategy:
          runOnce:
            deploy:
              steps:
                - download: current
                  artifact: Package

                - checkout: terraform-modules
                - checkout: self

                - template: "terraform-plan-apply.yaml/@terraform-modules"
                  parameters:
                    workingDirectory: ${{parameters.workingDirectory}}
                    azureSubscription: ${{parameters.azureSubscription}}
                    backendAzureRmStorageAccountName: ${{parameters.backendAzureRmStorageAccountName}}
                    # 将参数移至parameters块内
                    environment: ${{parameters.tfEnvironment}}
                    varsFile: ${{parameters.varsFile}}

额外说明 #

阶段名称属于流水线编译时确定的元素，必须使用${{...}}模板表达式语法取值。如果用$(environment.uat)这种运行时变量语法，会被当作字符串直接输出，就会出现你之前遇到的stage_$(environment.uat)$(region.uk)Deploy情况。

内容的提问来源于stack exchange，提问作者Stuart.Sklinar