Azure DevOps YAML流水线functionHostKey变量替换为空问题排查

这是一套部署用YAML流水线的一部分，需从密钥库获取function host key，将其作为输出变量传入下一阶段，供其他文件调用时替换使用。

相关任务代码如下：

- task: AzureCLI@2
    name: outputs
    displayName: Get Hostkey
    inputs:
      azureSubscription: ${{parameters.azureServiceConnection}}
      scriptType: bash
      scriptLocation: inlineScript
      addSpnToEnvironment: true
      inlineScript: |
        functionHostKey=$(sh pipelines/templates/getHostKey.sh ${{parameters.functionAppName}})
        echo "##vso[task.setvariable variable=functionHostKey;isoutput=true]$functionHostKey"

  - task: PythonScript@0
    inputs:
      scriptSource: 'filePath'
      scriptPath: '$(Pipeline.Workspace)/_search/scripts/deployment-script/deployBlob.py'
      inputVar: $[ dependencies.AzureCLI@2.outputs['functionHostKey'] ]
    env:
      custom_skill_uri: "https://${{parameters.functionAppName}}.azurewebsites.net/api/skill-customfields?code=${{variables.functionHostKey}}&clientId=default"
      functionHostKey: ${{variables.functionHostKey}}
      search_key: ${{parameters.cognitiveSearchKey}}
      search_endpoint: "https://${{parameters.cognitiveSearchName}}.search.windows.net"
      datasource_name: km3-datasource
      app_id : ${{parameters.appId}}
      app_secret : ${{parameters.appSecret}}
      tenant_id : ${{parameters.tenantId}}
      cog_multi_account_serv_key : ${{parameters.cognitiveAccountKey}}
      indexer_name : km3-indexer
      index_name : km3-index
      skillset_name : km3-skillset
      api_version : 2021-04-30-Preview
      search_service_name : ${{parameters.cognitiveSearchName}}
      pipeline_workspace : '$(Pipeline.Workspace)'
      storage_conString: ${{parameters.storageConnectionString}}
      container: ${{parameters.container}}
      folder: ${{parameters.folder}}

运行流水线时，Get Hostkey任务可正常获取主机密钥，但custom_skill_uri中的functionHostKey变量替换为空，生成的URI为：

https://funcappname.azurewebsites.net/api/skill-customfields?code=&clientId=default

若改用宏语法$(functionHostKey)，则URI显示为：

https://funcappname.azurewebsites.net/api/skill-customfields?code=$(functionHostKey)&clientId=default

请问该问题的原因是什么？是否是跨阶段环境变量接收不当或变量赋值错误？

核心原因 #

• 变量替换时机不匹配：你用了${{variables.functionHostKey}}，这是编译时变量，流水线初始化阶段就会解析，但functionHostKey是AzureCLI任务运行时生成的输出变量，编译时还未存在，所以替换为空。
• 同阶段变量引用语法错误：两个任务在同一阶段，不需要用dependencies语法，而且引用同阶段输出变量的正确格式是$(任务名.变量名)，不是dependencies.AzureCLI@2.outputs。

修复步骤 #

1. 修正变量引用语法：
   对于运行时生成的变量，要使用宏语法$(outputs.functionHostKey)或者运行时表达式$[variables['outputs.functionHostKey']]，不能用编译时的${{}}语法。同时修正inputVar的引用格式。

2. 调整后的PythonScript任务代码：

- task: PythonScript@0
    inputs:
      scriptSource: 'filePath'
      scriptPath: '$(Pipeline.Workspace)/_search/scripts/deployment-script/deployBlob.py'
      inputVar: $(outputs.functionHostKey)
    env:
      custom_skill_uri: "https://${{parameters.functionAppName}}.azurewebsites.net/api/skill-customfields?code=$(outputs.functionHostKey)&clientId=default"
      functionHostKey: $(outputs.functionHostKey)
      # 其他环境变量保持不变
      search_key: ${{parameters.cognitiveSearchKey}}
      search_endpoint: "https://${{parameters.cognitiveSearchName}}.search.windows.net"
      datasource_name: km3-datasource
      app_id : ${{parameters.appId}}
      app_secret : ${{parameters.appSecret}}
      tenant_id : ${{parameters.tenantId}}
      cog_multi_account_serv_key : ${{parameters.cognitiveAccountKey}}
      indexer_name : km3-indexer
      index_name : km3-index
      skillset_name : km3-skillset
      api_version : 2021-04-30-Preview
      search_service_name : ${{parameters.cognitiveSearchName}}
      pipeline_workspace : '$(Pipeline.Workspace)'
      storage_conString: ${{parameters.storageConnectionString}}
      container: ${{parameters.container}}
      folder: ${{parameters.folder}}

补充说明 #

• 只有跨阶段引用输出变量时，才需要用dependencies.阶段名.outputs['任务名.变量名']的语法，同一阶段直接通过$(任务名.变量名)调用即可。
• 宏语法$(变量名)会在任务执行前解析，运行时表达式$[变量名]支持复杂逻辑判断，这里用宏语法即可满足需求。

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