Docker部署的自定义Azure DevOps构建代理中Testcontainers卷挂载问题求助

挂载宿主机docker.sock到代理容器后，所有Testcontainers发起的容器创建请求都会直接提交到宿主机Docker daemon，而非代理容器内部的虚拟Docker环境。当Testcontainers尝试将代理容器内的编译文件路径挂载到测试容器时，Docker daemon会去宿主机上查找对应路径，而该路径在宿主机上不存在，最终导致读取失败。

步骤1：调整构建代理镜像配置 #

修改镜像的Dockerfile，将ENTRYPOINT改为绝对路径，避免工作目录变动后启动脚本找不到：

ENTRYPOINT [ "/azp/start.sh" ]

无需修改start.sh内的逻辑，原有代理初始化流程可正常运行。

步骤2：创建宿主机对齐工作目录 #

在Azure Ubuntu 20.04宿主机上执行以下命令，创建与代理容器内路径完全一致的工作目录，并配置对应权限：

sudo mkdir -p /opt/azp-agent-workspace
# 以下UID/GID需与代理容器内运行DevOps代理的用户ID、组ID保持一致，避免权限问题
sudo chown 1000:1000 /opt/azp-agent-workspace

步骤3：调整代理容器启动参数 #

使用以下命令启动构建代理，确保工作目录在宿主机和代理容器内路径完全对齐：

docker run -d --name build-agent-java-1 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /opt/azp-agent-workspace:/opt/azp-agent-workspace \
  -e AZP_URL=https://dev.azure.com/my-organisation \
  -e AZP_TOKEN=<mytoken> \
  -e AZP_AGENT_NAME=agent-1 \
  -e AGENT_WORKFOLDER=/opt/azp-agent-workspace \
  -w /opt/azp-agent-workspace \
  custombuildagentcr.azurecr.io/ubuntu1804-java11

参数说明：

• -v /opt/azp-agent-workspace:/opt/azp-agent-workspace：将宿主机工作目录与代理容器内工作目录双向绑定，保证两边路径完全一致
• -e AGENT_WORKFOLDER=/opt/azp-agent-workspace：指定DevOps代理的工作目录为绑定路径，所有拉取的代码、编译生成的文件都会存储在该目录下
• -w /opt/azp-agent-workspace：指定容器启动的默认工作目录

步骤4：流水线配置（可选） #

如果测试仍存在路径识别问题，可在Java构建流水线中添加Testcontainers环境变量：

export TESTCONTAINERS_HOST_OVERRIDE=localhost

该配置可确保Testcontainers正确识别宿主机网络地址，避免端口映射异常。

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