Azure Pipeline：通过Bash变量获取流水线变量值的问题

核心问题分析 #

问题出在混淆了Azure Pipeline的编译期模板表达式与运行时Bash脚本的执行逻辑：

• ${{ ... }}模板表达式在流水线启动前的编译阶段执行，仅能访问Pipeline的parameters、variables等编译期数据
• Bash脚本在流水线运行阶段执行，只能读取运行时环境变量或脚本内定义的变量

之前的错误要么是把变量名当作命令执行（触发command not found），要么是试图在编译期引用运行时的Bash变量（导致变量为空）。

方案一：编译期直接拼接变量名（推荐） #

你的environment参数和handler列表都是编译时已知的，可直接用Pipeline模板函数拼接变量名，在编译阶段就获取到对应变量值：

修改step-template.yaml中的Bash任务：

steps:
  - ${{ each handler in parameters.handlers }}:
    - bash: |
        # 编译阶段拼接变量名，直接获取Pipeline变量值
        prefix="${{ variables[format('{0}_{1}', parameters.environment, handler)] }}"
        echo "##vso[task.setvariable variable=prefix;]${prefix}"
      displayName: "Set prefix for ${{ handler }}"

    - bash: |
        # 后续任务直接使用$(prefix)即可
        echo "Current prefix: $(prefix)"
        # 此处编写你的业务逻辑代码
      displayName: "Execute logic with ${{ handler }}"

原理 #

• format('{0}_{1}', parameters.environment, handler)在编译阶段会直接生成完整变量名（如dev_handler1）
• variables[<变量名>]是Pipeline模板中通过变量名索引取值的语法，编译后会直接替换为对应变量的实际值（如prefix1）

方案二：运行时动态获取（适用于变量名运行时生成的场景） #

如果变量名是运行时动态生成的（编译期无法确定），可将Pipeline变量导出到Bash环境，再通过Bash的间接引用获取值：

steps:
  - ${{ each handler in parameters.handlers }}:
    - bash: |
        # 导出匹配规则的Pipeline变量到Bash环境
        set -a
        # 过滤并格式化变量为Bash可识别的格式（适配Azure Pipeline变量转大写的规则）
        source <(printenv | grep -E '^[A-Z]+_HANDLER[0-9]+' | sed 's/=/="/;s/$/"/')
        set +a

        # 拼接变量名并转为大写（匹配Azure Pipeline生成的环境变量格式）
        prefixVariable=$(echo "${{ parameters.environment }}_${{ handler }}" | tr '[:lower:]' '[:upper:]')
        # Bash间接引用：通过变量名获取对应值
        prefix="${!prefixVariable}"
        echo "##vso[task.setvariable variable=prefix;]${prefix}"
      displayName: "Set prefix for ${{ handler }}"

    - bash: |
        echo "Current prefix: $(prefix)"
        # 此处编写你的业务逻辑代码
      displayName: "Execute logic with ${{ handler }}"

原理 #

• Azure Pipeline会将变量名转为大写、非字母数字字符替换为下划线（如dev_handler1对应环境变量DEV_HANDLER1）
• set -a自动导出后续定义的变量，source将格式化后的环境变量导入Bash
• ${!prefixVariable}是Bash的间接引用语法，通过变量名字符串获取对应变量的值

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