Azure DevOps流水线变量在Python脚本中无法正常取值问题

问题现象 #

• 已在Azure Pipeline变量中添加秘密值SONAR_AUTH和普通文本变量KRISTAPS_VARIABLE
• YAML中配置变量时使用错误语法，导致Python脚本无法获取变量实际值：调用SonarQube API返回401错误，测试普通变量仅输出变量名而非实际内容

解决方案 #

1. 修正YAML变量引用语法 #

Azure DevOps中引用流水线变量必须使用$(变量名)格式，而非直接$变量名。修改YAML变量定义：

variables:
  SONAR_API_KEY: $(SONAR_AUTH)

2. 确保变量注入到任务环境 #

需要显式将流水线变量映射为任务的环境变量，有两种实现方式：

方法一：通过任务env字段映射

修改CmdLine任务配置，添加环境变量映射：

- task: CmdLine@2
  displayName: Retrieve SonarQube
  inputs:
    script: |
      echo -e "Starting the Python script for SonarQube"
      python3.8 $(Build.SourcesDirectory)/SonarQube.py
  env:
    SONAR_API_KEY: $(SONAR_API_KEY)
    KRISTAPS_VARIABLE: $(KRISTAPS_VARIABLE)

方法二：直接作为参数传递给Python脚本

在CmdLine脚本中将变量作为启动参数传给Python：

- task: CmdLine@2
  displayName: Retrieve SonarQube
  inputs:
    script: |
      echo -e "Starting the Python script for SonarQube"
      python3.8 $(Build.SourcesDirectory)/SonarQube.py $(SONAR_AUTH) $(KRISTAPS_VARIABLE)

对应修改Python脚本接收参数：

import sys
SONAR_API_KEY = sys.argv[1]
KRISTAPS_TEST = sys.argv[2]

3. 验证变量传递 #

修改Python脚本添加验证逻辑（注意：秘密变量在Azure DevOps日志中会被自动屏蔽，无法直接查看实际值）：

import os

KRISTAPS_TEST = os.environ.get("KRISTAPS_VARIABLE")
print(f"测试变量值: {KRISTAPS_TEST}")

SONAR_API_KEY = os.environ.get("SONAR_API_KEY")
# 仅验证变量是否存在，实际值会被替换为***
print(f"SONAR_API_KEY已注入: {SONAR_API_KEY is not None}")

额外注意事项 #

• 秘密变量在Azure DevOps日志中会自动脱敏，无法直接打印查看，只能通过API调用结果验证有效性
• 确认流水线变量的作用域正确（如是否针对当前阶段/任务生效）
• 使用Microsoft-hosted代理时，确认python3.8命令可用，也可尝试使用python或指定完整路径

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