Azure DevOps Server(本地)容器作业Checkout步骤失败求助

我之前处理过类似的容器构建故障，结合Azure DevOps Server 2019的特性，给你几个实用的排查和解决方向：

1. 检查自托管代理的工作区权限与缓存 #

• 确保代理运行用户对本地_work工作目录有完整读写权限，容器默认用root用户运行，可能和主机用户的权限映射冲突，导致文件枚举时出错。
• 清理代理缓存：停止代理服务，删除_work文件夹下的旧构建残留文件，重启代理后再尝试构建——缓存文件损坏是这类“集合修改”异常的常见诱因。

2. 调整容器运行的用户或权限映射 #

你可以显式指定容器运行的用户，或者提前修复工作区权限，避免容器内外权限不匹配：

pool: linux-container-build
container:
  image: ubuntu:16.04
  options: '-u $(id -u):$(id -g)' # 用代理主机的UID/GID运行容器，避免权限冲突
steps:
- script: whoami

或者在容器启动后先修正工作目录权限：

pool: linux-container-build
container: ubuntu:16.04
steps:
- script: chown -R $(id -u):$(id -g) $(System.DefaultWorkingDirectory)
  displayName: 'Fix workspace permission mapping'
- script: whoami

3. 更新自托管代理到对应Server版本的最新补丁 #

Azure DevOps Server 2019的早期代理版本存在容器构建的兼容性bug，这类枚举异常在后续补丁中被修复过。你可以下载对应Server版本的最新代理安装包，替换旧代理后再测试。

4. 修复容器内Git客户端的兼容性问题 #

Ubuntu 16.04默认的Git版本可能和Azure DevOps Server的Git服务不兼容，导致拉取代码时出现异常。可以在容器内手动安装兼容的Git版本：

pool: linux-container-build
container: ubuntu:16.04
steps:
- script: |
    apt-get update && apt-get install -y git=1:2.7.4-0ubuntu1.10
  displayName: 'Install Git version compatible with Azure DevOps Server 2019'
- script: whoami

5. 禁用流水线的浅克隆设置 #

浅克隆（Shallow Clone）可能导致Git文件枚举时出现异常，你可以在流水线的Get Sources配置中取消浅克隆，或者在yaml中显式配置拉取完整仓库：

steps:
- checkout: self
  fetchDepth: 0 # 禁用浅克隆，拉取完整仓库历史

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