如何在本地Azure Build Agent上正确配置可读取的环境变量

这个问题和MSBuild的环境变量特殊读取规则没有关联，核心原因是Azure Build Agent的运行上下文与你设置的环境变量作用域不匹配：

• 不带/m参数执行setx命令时，默认写入的是当前操作用户的用户级环境变量，仅以该用户身份启动的进程可以读取这部分配置。
• 自行安装Azure Build Agent时，默认选项是将代理注册为Windows后台服务运行，这类服务的默认运行身份是Local System、Network Service这类内置系统账号，并非你平时登录系统、启动Visual Studio使用的个人用户账号，系统账号完全无法读取你给个人账号配置的用户级环境变量。
• 本地Visual Studio运行测试正常，是因为Visual Studio本身就是用你的个人账号启动的，自然能读取对应账号下的环境变量，和构建代理的运行环境是完全隔离的两套上下文。

你执行setx命令的操作示例：
cmd.exe操作截图

选择以下任意一种方案处理即可：

• 方案1：设置系统级环境变量（推荐，适配服务模式运行的代理）
  右键点击命令提示符，选择「以管理员身份运行」，执行带/m参数的setx命令，将变量设置为所有账号都可读取的系统级环境变量：

  setx OrderEntryClient:UnitTestCredentials:UserName "UserName123" /m
  setx OrderEntryClient:UnitTestCredentials:Password "Password123456" /m
  

  执行完成后，打开Windows服务管理器，找到Azure Build Agent对应的服务，右键选择重启即可，无需重启整台设备。

• 方案2：修改代理服务运行账号（不希望设置系统级变量时使用）
  打开Windows服务管理器，找到Azure Build Agent服务，进入「属性-登录」配置页，将服务的运行账号修改为你平时登录系统使用的个人Windows账号，保存配置后重启服务即可。

• 方案3：交互模式代理适配
  如果你没有将代理注册为后台服务，而是手动执行代理目录下的run.cmd以交互模式启动代理，注意必须在设置完环境变量、重新登录系统后，新开命令提示符窗口执行启动脚本——设置环境变量前就已经打开的旧终端会继承启动时的旧环境配置，不会自动加载新修改的变量。

可以直接在构建流水线中添加一个命令行任务，执行set命令打印当前构建进程能读取到的所有环境变量，直接确认目标变量是否存在，比通过单元测试输出排查效率高很多。

你本地读取环境变量的代码逻辑本身没有问题，示例代码如下：

private static string _user;
private static string _pass;

[ClassInitialize]
public static void ClassInit(TestContext ctx)
{
    IConfiguration config = new ConfigurationBuilder()
        .AddEnvironmentVariables()
        .Build();

    _user = config["OrderEntryClient:UnitTestCredentials:UserName"];
    _pass = config["OrderEntryClient:UnitTestCredentials:Password"];

    Console.WriteLine($"Here are my vars:{_user}-{_pass}");
}

本地运行的正常输出为：

Here are my vars:UserName123-Password123456

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