Azure Pipelines构建代理为何未使用最新版本？

可能的原因 #

• 滚动标签的区域推送延迟：微软托管代理的windows-2022这类通用滚动标签并非实时同步所有区域的最新镜像，新版本会分批次推送到不同区域的代理池，你的组织所在区域可能还未完成更新。
• 代理复用机制：如果流水线开启了代理复用，会持续使用之前分配的旧版本代理虚拟机，不会自动切换到新镜像环境。
• 组织级镜像版本锁定：部分组织会通过Azure DevOps的组织设置，锁定特定代理镜像版本，避免自动更新带来的不稳定，这会导致流水线无法获取最新镜像。

解决办法 #

1. 直接指定目标版本号 #

既然已知需要的修复版本是20250623，在YAML中直接指定该版本号，绕过滚动标签的延迟：

pool:
  vmImage: 'windows-2022@20250623'

这样可强制流水线使用包含修复的指定镜像版本。

2. 禁用代理复用 #

若开启了代理复用，在YAML中添加配置强制分配新代理：

pool:
  vmImage: 'windows-2022'
  demands:
    - Agent.Name -equals $(Agent.Name)

也可在流水线的「代理作业」设置中，取消勾选「允许代理复用」选项。

3. 检查组织代理设置 #

登录Azure DevOps组织后台，进入「代理池」→「微软托管代理」，查看是否存在针对windows-2022镜像的版本锁定规则，若有则调整为允许使用最新版本。

4. 等待区域推送完成 #

如果是区域推送延迟导致，微软通常会在1-3天内完成全区域镜像部署，间隔一段时间后重新运行流水线，大概率会自动获取到新版本镜像。

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