从键值文件读取值传递至Azure DevOps模板失败求助

问题背景 #

开发Azure DevOps流水线时，通过命令echo "##vso[task.setvariable variable=$key;isOutput=true]$value"从键值文件读取值并设置为输出变量，后续任务能正常读取这些变量，但将其作为参数传递给模板时失败，模板执行时控制台提示"command not found"。现有资料大多提及${{parameters.varname}}的传参方式，但缺少动态变量传递模板的实践示例。

问题原因 #

1. 跨阶段输出变量引用路径错误：主流水线传递模板参数时，依赖引用使用dependencies而非stageDependencies，无法正确获取跨阶段的运行时输出变量。
2. 编译时与运行时表达式混淆：模板中用${{ parameters.xxx }}编译时表达式引用动态参数，但动态变量是运行时生成的，编译时无法解析为空，导致AWS命令因参数缺失执行失败。

解决方案 #

1. 修正主流水线模板参数的依赖引用 #

将主流水线中模板参数的dependencies替换为stageDependencies，正确引用格式为：

$[ stageDependencies.LoadEnvironment.LoadEnvVariables.outputs['LoadEnvironmentValues.变量名'] ]

修改后的主流水线模板调用片段：

- template: greengrass-component-deployment-templ.yml
  parameters:
    COMPONENT_VERSION: $[ stageDependencies.LoadEnvironment.LoadEnvVariables.outputs['LoadEnvironmentValues.COMPONENT_VERSION'] ]
    GW_VERSION: $[ stageDependencies.LoadEnvironment.LoadEnvVariables.outputs['LoadEnvironmentValues.GW_VERSION'] ]
    SSO_ACCOUNT_ID: $[ stageDependencies.LoadEnvironment.LoadEnvVariables.outputs['LoadEnvironmentValues.SSO_ACCOUNT_ID'] ]
    AWS_REGION: $[ stageDependencies.LoadEnvironment.LoadEnvVariables.outputs['LoadEnvironmentValues.AWS_REGION'] ]
    GG_BUCKET_NAME: $[ stageDependencies.LoadEnvironment.LoadEnvVariables.outputs['LoadEnvironmentValues.GG_BUCKET_NAME'] ]
    KINESIS_STREAM: $[ stageDependencies.LoadEnvironment.LoadEnvVariables.outputs['LoadEnvironmentValues.KINESIS_STREAM'] ]
    CORE_DEVICE: $[ stageDependencies.LoadEnvironment.LoadEnvVariables.outputs['LoadEnvironmentValues.CORE_DEVICE'] ]

    AWS_ACCESS_KEY_ID: ${{ parameters.AWS_ACCESS_KEY_ID }}
    AWS_SECRET_ACCESS_KEY: ${{ parameters.AWS_SECRET_ACCESS_KEY }}
    AWS_SESSION_TOKEN: ${{ parameters.AWS_SESSION_TOKEN }}

2. 模板内改用运行时表达式引用参数 #

模板中避免使用${{ parameters.xxx }}编译时表达式，改用运行时变量引用方式：

• Job级别定义变量时，用$[ parameters.xxx ]运行时表达式
• 脚本中直接用$(变量名)引用参数

修改后的模板核心片段：

jobs:
  - job: greengrass_component_deployment
    dependsOn: LoadEnvVariables
    variables:
      jobDeps: $[convertToJson(dependencies)]
      COMPONENT_VERSION: $[ parameters.COMPONENT_VERSION ]
      GW_VERSION: $[ parameters.GW_VERSION ]
      SSO_ACCOUNT_ID: $[ parameters.SSO_ACCOUNT_ID ]
      AWS_REGION: $[ parameters.AWS_REGION ]
      GG_BUCKET_NAME: $[ parameters.GG_BUCKET_NAME ]
      KINESIS_STREAM: $[ parameters.KINESIS_STREAM ]
      CORE_DEVICE: $[ parameters.CORE_DEVICE ]
    steps:
      - script: |
          echo "COMPONENT_VERSION - $(COMPONENT_VERSION)"
          echo "GW_VERSION is $(GW_VERSION)"
          echo "SSO_ACCOUNT_ID - $(SSO_ACCOUNT_ID)"
          # 其他变量输出...

  - job: VerifyS3FolderForGGComponent
    displayName: 'Verify Folder for Greengrass Component'
    pool:
      vmImage: 'ubuntu-latest'
    steps:
    - script: |
        echo "AWS_REGION: $(AWS_REGION)"
        echo "CORE_DEVICE: $(CORE_DEVICE)"
        echo "SSO_ACCOUNT_ID: $(SSO_ACCOUNT_ID)"
    - task: CmdLine@2
      displayName: 'Verify if Greengrass Folder Exists'
      inputs:
        script: |  
          echo "Verifying if component folder exists in s3 Bucket..."
          COMPONENT_FOLDER_EXISTS=$(aws s3api list-objects --bucket "$(GG_BUCKET_NAME)" --query 'Contents[].Key' --output text | grep -c "artifacts/com.test.dl.gs/$(COMPONENT_VERSION)") || echo "0"
          echo "Component Exists: $COMPONENT_FOLDER_EXISTS"
          echo "##vso[task.setvariable variable=COMPONENT_FOLDER_EXISTS]$COMPONENT_FOLDER_EXISTS"
    - task: CmdLine@2
      displayName: "When s3 bucket does not exist"
      condition: eq(variables['COMPONENT_FOLDER_EXISTS'], '0')
      inputs:
        script: |
          cd ./aws/greengrass
          ls -ltrh ./artifacts/com.test.dl.gs/$(COMPONENT_VERSION)
          aws s3 sync ./artifacts/com.test.dl.gs/$(COMPONENT_VERSION) s3://$(GG_BUCKET_NAME)/artifacts/com.test.dl.gs/$(COMPONENT_VERSION)/

3. 确认模板阶段依赖配置 #

模板内CreateOrUpdateComponent阶段已设置dependsOn: LoadEnvironment，确保在LoadEnvironment阶段完成后再执行模板任务，保证动态变量已生成。

关键说明 #

• Azure DevOps中，${{ }}是编译时表达式，流水线启动前求值；$[ ]是运行时表达式，流水线运行过程中求值，动态生成的变量必须用运行时表达式引用。
• 跨阶段引用输出变量时，必须使用stageDependencies.阶段名.作业名.outputs['任务名.变量名']的完整路径。

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