GitLab共享运行器中运行Mongo容器遇Docker连接失败求助

最优方案：直接使用GitLab CI服务启动MongoDB #

你不需要折腾Docker-in-Docker（dind）来启动Mongo容器，GitLab CI的services特性可以直接帮你启动Mongo服务，且自动处理网络连通性，这是更简单可靠的方式：

修改后的.gitlab-ci.yml配置：

default:
  image: python:3.10

test-job:
  stage: test
  services:
    - name: mongo:latest
      alias: mongo  # 可选，默认主机名就是服务名mongo
  script:
    - pip3 install virtualenv
    - virtualenv venv
    - source venv/bin/activate
    - pip3 install -r requirements.txt
    # 注意：Python代码中MongoDB连接地址需改为 mongodb://mongo:27017/
    - python -m pytest tests/

说明 #

• GitLab CI会自动将Mongo服务容器与你的测试容器放在同一网络，直接用服务名mongo作为主机名即可访问，默认端口27017无需额外映射。
• 完全规避了dind的配置复杂问题，减少出错概率。

修复原Docker-in-Docker方案（若必须在CI中操作容器） #

如果你的场景确实需要在CI中使用Docker命令，可通过以下步骤修复连接失败问题：

修改后的.gitlab-ci.yml配置：

default:
  image: python:3.10

variables:
  DOCKER_HOST: "tcp://docker:2375"
  DOCKER_DRIVER: overlay2
  DOCKER_TLS_CERTDIR: ""

services:
  - docker:dind

test-job:
  stage: test
  privileged: true  # 必须开启，dind运行需要特权模式
  script:
    - pip3 install virtualenv
    - virtualenv venv
    - source venv/bin/activate
    - pip3 install -r requirements.txt

    # 安装Docker客户端而非完整docker.io，避免版本兼容问题
    - 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

    # 等待Docker守护进程就绪
    - until docker info; do sleep 1; done

    # 启动Mongo容器并映射端口，确保测试容器能访问
    - docker run -d -p 27017:27017 --name mongo-container mongo:latest
    # 等待Mongo服务启动完成
    - until docker exec mongo-container mongosh --eval "db.adminCommand('ping')"; do sleep 1; done

    - python -m pytest tests/

关键修复点 #

1. 开启privileged: true：dind服务需要特权模式才能正常启动Docker守护进程，这是核心要求。
2. 安装Docker客户端而非完整docker.io：docker-ce-cli仅包含客户端工具，与dind的守护进程版本更兼容，避免冗余组件导致的冲突。
3. 添加就绪等待逻辑：确保Docker守护进程和Mongo服务完全启动后再执行测试，避免因服务未就绪导致的连接失败。

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