向Azure DevOps Environment添加VM资源时报Linked environment pool is null错误

问题原因 #

该报错Failed to add virtual machine resource. Linked environment pool is null是Azure DevOps环境与专属代理池的绑定关系异常导致，常见触发场景如下：

1. 配置命令中指定的--pool为组织级共享代理池，而非环境专属的隐式代理池。每个环境首次添加VM资源时，Azure DevOps会自动生成和环境绑定的专属隐式代理池，无需手动指定外部共享池，额外配置--pool参数会导致系统无法识别环境对应的专属池。
2. 目标DEV环境的默认配置被改动，例如手动删除了关联的隐式代理池，或是环境创建时出现后端数据异常，导致绑定关系丢失。
3. 所用PAT令牌权限不足，即便是组织管理员，若PAT未开启对应权限，也会触发该校验错误。
4. 注意你使用的--unattanded参数存在拼写错误，正确拼写为--unattended，错误的参数也可能导致配置逻辑异常。

解决方案 #

按以下步骤操作即可解决：

• 清理现有无效配置：登录Azure DevOps网页端，进入对应项目的「管道-环境」页面，打开DEV环境的「资源」标签，删除所有残留的无效VM资源。如果是测试环境可以直接删除DEV环境后重新创建，确保后端绑定的隐式代理池状态正常。
• 调整配置命令，删除多余的--pool参数，修正参数拼写，参考命令如下：

config --unattended --disableloguploads --environment --environmentname DEV --agent computername --runasservice --windowsLogonAccount xxx --windowsLogonPassword xxx --work _work --url https://dev.azure.com/xxx/ --projectname myprojectname --auth PAT --token xxx

• 校验PAT权限：确认你使用的PAT令牌已开启以下权限：
  • 代理池：读取和管理
  • 环境：读取和管理
  • 项目和团队：读取
• 重新执行配置：先进入代理安装目录运行config.cmd remove卸载之前的残留配置，再运行调整后的配置命令即可。

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