Azure Pipeline中Docker服务不定期启动失败问题排查求助

针对你用wsl -- bash -c "sudo service docker start"启动Docker服务时的不定期失败问题，这些实用思路可以尝试：

• 添加重试逻辑
  不定期失败大概率是临时资源竞争或环境未就绪导致的，给启动命令加循环重试：

  echo Start docker deamon
  MAX_RETRIES=3
  RETRY_COUNT=0
  until wsl -- bash -c "sudo service docker start"; do
      RETRY_COUNT=$((RETRY_COUNT+1))
      if [ $RETRY_COUNT -ge $MAX_RETRIES ]; then
          echo "Failed to start docker after $MAX_RETRIES retries"
          exit 1
      fi
      echo "Retry $RETRY_COUNT/$MAX_RETRIES in 5 seconds..."
      sleep 5
  done
  

• 确保WSL环境完全就绪
  有时候WSL实例还没完全初始化就执行Docker启动命令，先加个预检查确保WSL能正常响应：

  echo Waiting for WSL to be ready...
  until wsl -- bash -c "echo WSL is ready"; do
      sleep 2
  done
  echo Start docker deamon
  wsl -- bash -c "sudo service docker start"
  

• 消除sudo密码交互
  若WSL中sudo需要密码（即使托管代理通常免密，也可能存在配置波动），提前配置免密执行Docker启动命令：
  在Pipeline中先执行一次（可以放到初始化步骤）：

  wsl -- bash -c "echo '%sudo ALL=(ALL) NOPASSWD: /usr/sbin/service docker start' | sudo tee /etc/sudoers.d/docker-start && sudo chmod 0440 /etc/sudoers.d/docker-start"
  

  之后再执行启动命令就不会因为密码问题卡住。

• 改用Docker Desktop WSL集成
  如果你的Pipeline代理安装了Docker Desktop，开启WSL集成后，Docker服务会自动随WSL实例启动，无需手动执行service docker start。可以在Pipeline中检查Docker状态，未运行再触发启动（或直接依赖Docker Desktop的自动启动）。

• 增强日志排查
  失败时输出更多上下文日志，方便定位根因：

  echo Start docker deamon
  wsl -- bash -c "sudo service docker start"
  # 检查启动状态并输出日志
  wsl -- bash -c "sudo service docker status || sudo journalctl -u docker.service --no-pager -n 20"
  

• 切换代理环境
  微软托管代理的WSL配置可能存在实例间差异，试试：

  • 指定特定版本的托管代理（比如选择Ubuntu 22.04而非最新预览版）
  • 改用自我托管代理，控制WSL和Docker的配置一致性

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