Azure DevOps Pipeline中Azure File Copy任务失败求助

针对AzureFileCopy@5任务报错AzCopy.exe exited with non-zero exit code while uploading files to blob storage，结合你已配置IAM角色的情况，可从以下几个方向排查：

1. 确认SourcePath路径有效性 #

• 检查wwwroot/*是否存在于Pipeline运行的工作目录中。如果是构建产物，建议使用绝对路径，比如$(Build.ArtifactStagingDirectory)/wwwroot/*，避免因工作目录切换导致路径找不到。
• 可在AzureFileCopy任务前添加一个CmdLine@2任务，执行目录验证：

  - task: CmdLine@2
    displayName: Verify Source Files
    inputs:
      script: 'dir wwwroot'
  

2. 验证IAM角色的权限范围与类型 #

• 确保为服务主体分配的是**存储Blob数据参与者（Storage Blob Data Contributor）**角色，而非仅存储账户管理类角色（如存储账户参与者）——Blob上传操作需要的是数据权限，不是管理权限。
• 检查角色的作用范围：需将角色直接分配到目标存储账户YYYYYY或其下的容器XXXXXXXX，避免作用范围过宽或过窄。

3. 启用AzCopy详细日志定位具体错误 #

• 在AzureFileCopy任务的inputs中添加additionalArgumentsForAzCopy: '--verbose'，获取更详细的AzCopy执行日志，精准定位是权限、文件、网络还是容器配置问题：

  - task: AzureFileCopy@5
    displayName: Copy Files to CDN Origin
    inputs:
      SourcePath: 'wwwroot/*'
      azureSubscription: 'aaaaaa-bbbb-cccc-dddd-eeeeeeeeeee'
      Destination: 'AzureBlob'
      storage: 'YYYYYY'
      ContainerName: 'XXXXXXXX'
      additionalArgumentsForAzCopy: '--verbose'
  

4. 检查存储账户与容器的网络配置 #

• 如果存储账户启用了防火墙或虚拟网络限制，需确认是否允许Azure DevOps的访问：
  • 在存储账户的“网络”设置中，勾选“允许受信任的Microsoft服务访问此存储账户”。
  • 或者添加Azure DevOps代理所在的IP地址到存储账户的防火墙允许列表。
• 确认目标容器XXXXXXXX已存在，且容器的访问级别设置符合需求（私有容器需依赖IAM权限，匿名容器需确保上传操作被允许）。

5. 验证服务连接的权限完整性 #

• 确保azureSubscription对应的服务连接（服务主体）拥有存储账户的读取权限，任务在执行上传前需要读取存储账户的基础信息（如Blob端点），缺少该权限会导致AzCopy初始化失败。

内容的提问来源于stack exchange，提问作者eat-sleep-code