Azure DevOps微软托管Windows代理构建Windows Docker镜像报错求助

核心解决方案：每次Pipeline运行时强制切换容器模式 #

微软托管的Windows代理默认启动为Linux容器模式，必须在Docker构建前通过脚本切换到Windows容器模式，具体步骤如下：

• 添加容器模式切换脚本
  在Docker构建任务前插入PowerShell任务，执行Docker守护进程切换命令：

  - task: PowerShell@2
    displayName: '切换到Windows容器模式'
    inputs:
      targetType: 'inline'
      script: |
        & "C:\Program Files\Docker\Docker\DockerCli.exe" -SwitchDaemon
  

  该命令会直接调用Docker CLI工具切换容器运行时环境。

• 可选：验证切换结果
  可以追加一个验证任务，确认容器模式切换成功，避免后续构建无意义失败：

  - task: PowerShell@2
    displayName: '确认Windows容器模式'
    inputs:
      targetType: 'inline'
      script: |
        docker info --format '{{.OSType}}'
  

  执行成功后控制台会输出windows，表示切换生效。

• 适配Docker构建任务
  确保你的Docker构建任务（如Docker@2）使用的Dockerfile基于Windows基础镜像（例如mcr.microsoft.com/windows/servercore:ltsc2019），同时保证镜像版本与代理的Windows系统版本匹配（比如windows-2019代理对应Server 2019镜像）。

关键注意事项 #

• 微软托管代理是临时实例，每次Pipeline启动都会重置为默认的Linux容器模式，因此切换操作必须在每次运行时执行。
• 避免混用跨系统的基础镜像，Windows容器只能基于Windows镜像构建，反之亦然。

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