Docker容器中自托管Azure Agent性能异常：代码检出长时间卡顿

Windows环境中用Docker运行Azure自托管Agent时，大仓库克隆/检出卡顿是不少用户遇到的共性问题，核心原因多集中在Docker的IO性能瓶颈、资源限制或Git配置优化不足上，以下是针对性的解决思路：

• 优化Docker文件系统挂载性能
  Windows Docker默认采用CIFS协议挂载宿主机目录到容器，IO性能远低于本地。建议：

  1. 确保Docker Desktop启用WSL2引擎（设置>通用>勾选"Use the WSL 2 based engine"）；
  2. 将Agent的工作目录映射到WSL2的文件系统路径（而非Windows原生路径），比如把-v C:\agent\_work:/agent/_work替换为-v /home/your-user/agent_work:/agent/_work（WSL内的路径），大幅提升文件读写速度。

• 调整Git配置参数
  在流水线的前置任务或Agent容器启动脚本中添加Git优化配置，针对大仓库提升处理效率：

  git config --global core.compression 0  # 关闭压缩减少CPU开销
  git config --global core.fscache true   # 启用文件系统缓存
  git config --global core.preloadindex true  # 预加载索引加速文件状态检查
  git config --global core.threads 8     # 增加并行处理线程数（根据CPU核心调整）
  

• 改用宿主机Git客户端
  容器内置的Git可能性能有限，可挂载宿主机的Git到容器中使用：
  启动容器时添加挂载参数：-v "C:/Program Files/Git:/host-git"，然后在Agent配置中更新环境变量PATH=$PATH:/host-git/bin，或在流水线任务中指定git.path: /host-git/bin/git。

• 调高Docker资源配额
  默认Docker给容器的CPU、内存配额不足会拖慢大仓库处理：
  打开Docker Desktop>设置>资源，将CPU调整为4核以上，内存调整为8GB以上，避免资源瓶颈导致任务卡死。

• 调整克隆策略
  若浅克隆效果不佳，可尝试：

  - checkout: self
    clean: false
    fetchDepth: 5  # 适度增加深度而非仅拉取最新提交，减少增量更新冲突
    persistCredentials: true  # 保留凭证，后续任务可复用已有仓库
  

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