Azure发布管道经典Python任务访问变量遇KeyError问题

核心原因 #

经典Python任务不会自动将管道变量映射为系统环境变量，哪怕变量标记为机密也是如此，直接用os.environ['变量名']自然拿不到对应值。

解决方案 #

1. 显式传递管道变量为Python脚本参数 #

在经典Python任务的参数输入框中，将所需变量以命令行参数形式传入：

--url $(url) --token $(token) --location $(location) --version $(version)

随后在Python脚本里用argparse解析参数：

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--url', required=True)
parser.add_argument('--token', required=True)
parser.add_argument('--location', required=True)
parser.add_argument('--version', required=True)
args = parser.parse_args()

# 使用参数
print(args.url)
print(args.token)

2. 通过前置Shell/PowerShell任务注入环境变量 #

如果不想修改脚本的参数逻辑，可以先添加一个Shell（Linux代理）或PowerShell（Windows代理）任务，将管道变量写入环境变量：

• PowerShell示例：

$env:URL = "$(url)"
$env:TOKEN = "$(token)"
$env:LOCATION = "$(location)"
$env:VERSION = "$(version)"
# 执行Python脚本
python your_script.py

• Bash示例：

export URL=$(url)
export TOKEN=$(token)
export LOCATION=$(location)
export VERSION=$(version)
# 执行Python脚本
python your_script.py

这种方式下，原脚本里的os.environ['URL']（注意环境变量名默认会转为大写）即可获取到值，且机密变量会被系统自动屏蔽日志，不会泄露。

3. 在任务配置中手动映射环境变量 #

若经典Python任务有环境变量配置项，可手动添加映射规则：

• 名称填写脚本中使用的变量名（比如url），值填写$(url)
• 机密变量也可按此方式配置，系统会自动处理安全传递逻辑

内容的提问来源于stack exchange，提问作者mannar-senpai