Azure DevOps Build Pipeline无法识别Docker卷挂载问题求助

问题根因与解决方案 #

1. 最常见原因：Docker-in-Docker 挂载路径错位 #

如果你用的AzDo代理本身运行在Docker容器中（不管是自托管容器化代理，还是部分托管容器化运行环境），你在代理中拿到的$(System.DefaultWorkingDirectory)是代理容器内部的路径，直接传给docker run -v参数时，宿主机的Docker daemon会把这个路径当做宿主机本地路径去查找，自然找不到对应的文件，最终只会创建空目录挂载到容器内。

对应解决方案：

• 方案1：放弃挂载方式，先将需要的文件拷贝到容器内再执行命令，示例逻辑：

  # 先创建临时容器
  docker create -i --name test-temp dockerimage ls -ltrR /app/
  # 拷贝本地文件到容器内对应路径
  docker cp $(System.DefaultWorkingDirectory)/Script/ test-temp:/app/ScriptStages/
  docker cp $(System.DefaultWorkingDirectory)/Test/ test-temp:/app/Test/
  # 启动容器执行命令
  docker start -i test-temp
  # 执行完清理临时容器
  docker rm test-temp
  

• 方案2：如果是自托管代理，部署代理容器时将宿主机的工作目录和代理容器内的$(System.DefaultWorkingDirectory)映射为同一路径，保证宿主机Docker daemon能找到对应文件。

2. 路径特殊字符/空格截断问题 #

如果你的$(System.DefaultWorkingDirectory)路径中包含空格、中文或者特殊符号，没有加引号的话路径会被截断，导致Docker找不到对应目录。

对应解决方案：

给挂载路径参数加上双引号，同时在执行docker run前先打印完整命令确认变量展开正确：

echo "当前执行的Docker命令：docker run -v \"$(System.DefaultWorkingDirectory)/Script/:/app/ScriptStages/\" -v \"$(System.DefaultWorkingDirectory)/Test/:/app/Test/\" -i dockerimage ls -ltrR /app/"
docker run -v "$(System.DefaultWorkingDirectory)/Script/:/app/ScriptStages/" -v "$(System.DefaultWorkingDirectory)/Test/:/app/Test/" -i dockerimage ls -ltrR /app/

3. Linux 环境SELinux权限限制 #

如果你的AzDo代理运行在开启了SELinux的Linux系统中，默认安全规则会阻止容器访问宿主机挂载的目录，即使目录权限正确也会显示为空。

对应解决方案：

在挂载参数末尾添加:z（多容器共享挂载内容）或者:Z（仅当前容器独占挂载内容）标签：

docker run -v "$(System.DefaultWorkingDirectory)/Script/:/app/ScriptStages/:z" -v "$(System.DefaultWorkingDirectory)/Test/:/app/Test/:z" -i dockerimage ls -ltrR /app/

4. 容器运行用户权限不匹配 #

如果你的镜像默认运行的是非root用户，该用户没有权限读取你挂载的宿主机目录内容，也会出现目录为空的情况。

对应解决方案：

执行docker run时临时指定用root用户启动容器验证：

docker run --user root -v "$(System.DefaultWorkingDirectory)/Script/:/app/ScriptStages/" -v "$(System.DefaultWorkingDirectory)/Test/:/app/Test/" -i dockerimage ls -ltrR /app/

5. Windows代理运行Linux容器的路径格式问题 #

如果你用的是Windows系统的AzDo代理，要运行Linux容器，需要把Windows格式的路径转换为WSL兼容的路径再挂载：

# 转换Windows路径为WSL路径
WSL_WORKDIR=$(wsl -e wslpath -a "$(System.DefaultWorkingDirectory)")
docker run -v "$WSL_WORKDIR/Script/:/app/ScriptStages/" -v "$WSL_WORKDIR/Test/:/app/Test/" -i dockerimage ls -ltrR /app/

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