GitLab流水线中Maven Docker镜像内运行Testcontainer失败问题咨询

问题根因 #

你当前的配置存在两个核心问题：

1. 使用的maven:3.8.2-jdk-11镜像默认未预装Docker客户端，Testcontainer必须依赖Docker客户端才能和DinD守护进程通信
2. 未预留DinD服务启动时间，直接执行测试时DinD还未完成初始化，导致连接被拒绝

修复后的配置 #

services:
  # 固定DinD镜像版本，避免不同版本间的兼容性问题
  - docker:20.10.24-dind

variables:
  DOCKER_HOST: "tcp://docker:2375"
  DOCKER_TLS_CERTDIR: ""
  DOCKER_DRIVER: overlay2
  # 关闭Testcontainer默认的Ryuk资源回收容器，避免DinD下权限冲突
  TESTCONTAINERS_RYUK_DISABLED: "true"

test:
 image: maven:3.8.2-jdk-11
 stage: test
 before_script:
   # 安装与DinD版本匹配的Docker客户端
   - apt-get update
   - apt-get install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common
   - curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
   - add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
   - apt-get update && apt-get install -y docker-ce-cli=5:20.10.24~3-0~debian-bullseye
   # 等待DinD服务完全启动后再执行测试
   - until docker info; do sleep 1; echo "等待DinD服务启动..."; done
 script:
   - mvn -e test -f project_folder/pom.xml

关键修改说明 #

• 移除了无意义的chmod -R 777 /var/操作，该操作不会解决问题，还存在严重安全风险
• 固定DinD和Docker客户端版本为同一发行版，避免版本兼容问题导致的通信失败
• 新增Docker客户端安装步骤，满足Testcontainer的运行依赖
• 新增DinD服务就绪检查，确保服务完全启动后再执行测试
• 新增Ryuk容器关闭配置，规避DinD环境下的权限限制问题

额外排查项 #

如果修改配置后仍报错，请确认以下配置：

• GitLab Runner侧必须开启privileged = true，DinD服务仅能在特权模式下正常运行
• 项目中Testcontainer依赖版本升级到1.17.6以上，旧版本对DinD环境适配存在缺陷
• 不要手动指定TESTCONTAINERS_DOCKER_CLIENT_STRATEGY环境变量，保持默认自动检测即可

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