咨询：无需卸载现有AzDO自托管代理升级至3.2版本失败问题

核心结论 #

可以无需卸载现有代理直接升级至3.x版本，自动更新仅到2.218.1是因为AzDO的自动更新通道不会跨大版本推送3.x系列。

具体操作步骤 #

• 停止当前代理服务
  • Windows环境：执行命令 net stop vstsagent.{代理池名称}.{代理名称}
  • Linux/macOS环境：执行命令 ./svc.sh stop
• 获取对应系统的3.x版本代理安装包，解压到现有代理的安装目录，保留.agent和.credentials配置文件不覆盖（这两个文件存储代理的核心配置信息）
• 重启代理服务
  • Windows环境：执行命令 net start vstsagent.{代理池名称}.{代理名称}
  • Linux/macOS环境：执行命令 ./svc.sh start
• 验证版本：在AzDO代理页面查看代理版本，确认已升级至3.x系列

关键说明 #

微软官方文档提到的"自动升级"仅针对同大版本内的更新，3.x属于跨大版本迭代，无法通过AzDO页面的自动更新触发，必须通过手动覆盖文件的方式完成升级，且无需卸载原有代理。

内容的提问来源于stack exchange，提问作者Ahmed A.