经典DevOps发布流水线从包源下载包出现不一致失败问题

问题现象 #

• 多条经典发布流水线此前运行正常，现出现通用包下载的不一致失败：
  • 从NZ-Release源下载持续报超时错误
  • 从NZ-Test源下载正常成功
• 失败流水线的下载任务超时设为0（继承父流水线配置），但未找到父流水线的超时设置；新建测试流水线手动设置超时10分钟，仍报相同超时错误
• 在部署组机器上手动运行相同下载命令（传入UNIVERSAL_DOWNLOAD_PAT）可在数秒内成功
• 正常流水线与失败流水线命令行完全一致，仅包源不同；新建测试流水线无论使用哪个包源均失败，但原NZ-Test流水线按计划执行仍正常

失败流水线报错信息 #

[command]C:\azagent\A1\_work\_tool\artifacttool\0.2.394\x64\ArtifactTool.exe universal download --feed CORRECTFEEDID --service https://vsrm.dev.azure.com/Hexagon-SI-Oceania/ --package-name hxgnnz --package-version 0.0.403 --path C:\azagent\A1\_work\r1\a/hxgnnz/ --patvar UNIVERSAL_DOWNLOAD_PAT --verbosity Error --filter ** --project CORRECTPROJECTID
2025-04-28T23:39:02.1378277Z {"@t":"2025-04-28T23:39:02.0823358Z","@m":"Encountered an unexpected error.","@i":"b8be900d","@l":"Error","@x":"Microsoft.VisualStudio.Services.Content.Common.AsyncHttpRetryHelper+RetryableException: Attempt timed out after 00:01:00

手动运行成功的命令及输出 #

>C:\azagent\A2\_work\_tool\artifacttool\0.2.394\x64\ArtifactTool.exe universal download --feed CORRECTFEEDID --service https://vsrm.dev.azure.com/Hexagon-SI-Oceania/ --package-name hxgnnz --package-version 0.0.403 --path C:\azagent\A1\_work\r1\a/hxgnnz/ --patvar UNIVERSAL_DOWNLOAD_PAT --verbosity Error --filter ** --project CORRECTPROJECTID
{"Version":"0.0.403","SuperRootId":...

排查与解决方案 #

1. 排查流水线使用的PAT权限与来源 #

• 进入流水线编辑页面，找到下载通用包的任务，检查是否使用了自定义PAT（存储在变量组或流水线变量中）
• 如果使用部署组服务连接，检查部署组代理的运行身份：默认使用代理所在Windows账户权限，确认是否配置了特定PAT
• 对比正常流水线（NZ-Test）和失败流水线（NZ-Release）的PAT变量：
  • 确认是否为同一PAT，且PAT拥有Packaging (Read)权限，覆盖NZ-Release源所在的项目/组织
  • 检查PAT是否过期或被撤销

2. 检查代理服务的网络差异 #

• 流水线运行使用Azure DevOps代理的网络上下文，手动运行是当前登录用户的上下文，可能存在差异：
  • 切换到部署组代理的运行账户，打开命令提示符运行下载命令，验证是否能成功
  • 检查代理账户是否有访问NZ-Release源的网络权限（防火墙、代理服务器规则）
  • 对比NZ-Release和NZ-Test源的包大小，确认是否存在流水线代理带宽限制导致的超时

3. 增强日志排查超时环节 #

• 在失败流水线的下载命令中添加--verbosity Debug参数，获取更详细的错误日志，定位超时发生在DNS解析、连接建立还是数据传输阶段

4. 重置部署组代理 #

• 部署组代理可能存在缓存或状态异常，尝试重启代理服务：
  • 在部署组机器的服务管理器中，找到Azure DevOps Agent服务并重启
  • 或在代理安装目录运行.\config.cmd restart命令

5. 检查包源与特定包状态 #

• 登录Azure DevOps门户，检查NZ-Release源是否处于维护状态、是否有访问限制
• 验证包hxgnnz@0.0.403是否存在损坏或存储节点故障，可尝试上传测试包用失败流水线下载验证

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