Docker容器内VSTS私有Agent执行嵌套容器任务时退出，错误码127

我之前也踩过类似的坑，错误码127本质就是系统找不到要执行的命令或脚本，结合你这种“Docker里的Agent再启动Docker任务容器”的嵌套场景，咱们可以从这几个方向逐一排查：

• 先确认Agent容器里装了Docker CLI
  要让Agent能调用Docker命令创建任务容器，它所在的容器必须先有Docker CLI工具。很多基础镜像（比如Ubuntu、Alpine）默认是不带的，你得在构建Agent镜像的时候加上安装步骤：
  比如Ubuntu环境：

  RUN apt-get update && apt-get install -y docker.io
  

  装完后在Agent容器里执行which docker验证，如果返回类似/usr/bin/docker的路径就没问题；要是没返回，说明docker不在PATH里，得做软链接或者调整环境变量。

• 验证Agent容器能否访问宿主机的Docker Daemon
  Agent里的Docker CLI需要连接宿主机的Docker Daemon才能真正创建新容器，这一步最容易出问题：

  1. 启动Agent容器时必须挂载宿主机的Docker套接字：

     docker run -v /var/run/docker.sock:/var/run/docker.sock ... <your-agent-image>
     

  2. 还要检查权限：宿主机的/var/run/docker.sock默认属于docker组，你要么把Agent容器里的运行用户加入docker组，要么（测试阶段）直接用root用户启动Agent容器，避免权限不足导致命令执行失败。

• 检查任务容器里是否存在你要执行的命令
  如果你在VSTS任务里指定了自定义命令或脚本，得确保这些命令在你用来跑任务的镜像里存在。比如你用了轻量的Alpine镜像，但任务里用了apt-get（Alpine用的是apk），那肯定会报“command not found”，返回127错误。

• 查看Agent的详细日志定位具体问题
  错误码127只是个笼统的提示，你得看Agent的日志才能知道到底是哪个命令找不到：

  • 启动Agent时可以设置日志级别为Debug，或者直接查看Agent容器的日志：

    docker logs <your-agent-container-id/name>
    

  日志里会明确标出“xxx: command not found”的具体命令，这样就能精准修复。

• 确认预览特性的配置是否符合要求
  再核对一下任务的配置：有没有指定正确的Docker镜像？工作目录的映射是否正确？有没有遗漏必要的参数？比如有些任务需要挂载Agent的工作目录到任务容器，要是路径配置错了，脚本找不到也会触发127错误。

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