如何在Windows自托管代理（VM规模集）中运行Docker守护进程

问题分析 #

你的报错核心指向两个关键问题：

• Docker守护进程未启动，或者客户端无权限访问docker_engine管道（Windows默认要求管理员权限连接Docker守护进程）
• PowerShell中执行docker命令时找不到可执行文件，原因是DockerInstaller安装的路径未被当前Pipeline进程的环境变量识别

解决方案 #

1. 确保自托管代理以管理员权限运行 #

Windows环境下Docker默认限制只有管理员权限的进程能访问守护进程管道，需调整代理服务的运行权限：

• 打开服务管理器（services.msc），找到Azure DevOps自托管代理服务
• 右键选择「属性」→「登录」，选择具备本地管理员权限的账户，或勾选「允许服务与桌面交互」
• 重启代理服务

2. 修正PowerShell任务的Docker路径问题 #

DockerInstaller@0会将Docker安装到C:\a\_tool\docker-stable\<版本号>\x64目录，但该路径不会自动加入当前Pipeline的环境变量，需手动指定或添加：

- powershell: |
    # 启动Docker服务
    Start-Service docker
    # 将Docker安装路径临时加入环境变量
    $dockerPath = "C:\a\_tool\docker-stable\17.09.0-ce\x64"
    $env:Path += ";$dockerPath"
    # 验证Docker状态
    docker version
  displayName: "启动Docker服务并验证"

3. 优化DockerInstaller任务配置（可选） #

若无需指定旧版本，建议安装最新稳定版Docker，减少版本兼容性问题：

- task: DockerInstaller@0
  inputs:
    dockerVersion: 'latest'

4. 在Docker@2任务中手动指定Docker路径（应急方案） #

如果环境变量仍不生效，可直接在Docker@2任务中指定Docker可执行文件路径：

- task: Docker@2
  displayName: "Build Docker Image"
  inputs:
    containerRegistry: "$(DockerRegistryServiceEndpointName)"
    repository: "$(ContainerRepository)"
    command: "build"
    Dockerfile: "**/Dockerfile"
    tags: |
      $(Build.BuildId)
      latest
    dockerExecutable: "C:\a\_tool\docker-stable\17.09.0-ce\x64\docker.exe"

5. 预配置VM镜像的Docker环境（推荐） #

为避免每次Pipeline重复安装Docker，建议在Windows VM规模集的镜像中预先完成配置：

• 提前安装Docker Desktop或Docker Engine
• 设置Docker服务为自动启动
• 确保代理运行账户拥有Docker访问权限

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