Azure DevOps中VMSS未显示在代理池且流水线报错求助

1. 验证VMSS与Azure DevOps的关联配置 #

• 检查VMSS的扩展设置：确认已安装Azure Pipelines Agent扩展，且扩展配置中的Azure DevOps组织URL、项目名称、代理池名称完全匹配（注意大小写）。
• 核对VMSS的服务主体权限：用于关联的服务主体必须拥有Azure DevOps组织的Agent Pool Administrator或Agent Pool Service Account权限，且已正确配置客户端密钥/证书。

2. 检查VMSS实例的状态与日志 #

• 查看Azure门户中VMSS实例的运行状态：确认实例处于Running状态，无启动失败或异常重启记录。
• 登录VMSS实例（RDP或SSH），查看代理日志：
  • Windows日志路径：C:\agent\_diag
  • Linux日志路径：/home/vsts/agent/_diag
  • 重点排查认证失败、网络连接超时、代理注册失败类报错，比如无法连接Azure DevOps组织API端点的信息。

3. 网络与防火墙配置检查 #

• 确认VMSS所在虚拟网络的出站规则：允许访问*.visualstudio.com、*.dev.azure.com及相关Azure服务端点（如Azure Storage、Azure Active Directory），开放443（HTTPS）端口。
• 检查Azure DevOps组织的IP允许列表：若组织设置了IP限制，需将VMSS的公网IP或虚拟网络地址段加入允许范围。

4. 代理池与流水线配置核对 #

• 确认流水线的池选择：流水线指定的代理池名称需与VMSS关联的池完全一致（注意拼写、大小写）。
• 检查代理池的容量设置：确认池的最大并行任务数、VMSS实例数上限大于0，且未被设置为禁用状态。

5. 手动注册代理测试 #

• 在VMSS实例上手动下载并注册Azure DevOps代理，测试是否能成功加入目标池：
  1. 从Azure DevOps组织的代理池页面获取代理包下载链接
  2. 运行配置命令（Linux示例）：

     ./config.sh --unattended --url https://dev.azure.com/your-org --pool your-pool --auth pat --token your-pat-token
     

     Windows环境使用config.cmd执行对应命令
     若手动注册失败，根据报错定位问题；若成功，说明自动注册的扩展配置存在异常。

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