Gitlab CI任务突发Docker守护进程连接失败问题求助

核心问题分析 #

报错Cannot connect to the Docker daemon at unix:///var/run/docker.sock的原因是：

1. 使用docker:dind服务时，未正确配置环境变量让Docker客户端指向DinD守护进程
2. 基础Dockerfile里的VOLUME "/var/run/docker.sock:/var/run/docker.sock"写法错误，VOLUME指令仅能定义容器内的目录，无法实现宿主机与容器的绑定挂载

具体调整项 #

1. 修改GitLab CI配置文件 #

添加环境变量，让Docker CLI连接到docker:dind服务的守护进程：

api_server_build_and_deploy:
  image: $CI_REGISTRY_IMAGE/ci_deploy
  stage: build
  services:
    - docker:dind
  # 新增环境变量配置
  variables:
    DOCKER_HOST: tcp://docker:2376
    DOCKER_TLS_CERTDIR: "/certs"
    DOCKER_TLS_VERIFY: 1
    DOCKER_CERT_PATH: "$DOCKER_TLS_CERTDIR/client"
  environment:
    name: Staging
  before_script:
    - docker login -u "$DOCKER_REGISTRY_USER" -p "$DOCKER_REGISTRY_PASSWORD" $DOCKER_REGISTRY
  script:
    # omitted for brevity

• DOCKER_HOST：指定连接到Docker服务容器的TCP地址（docker是服务名，GitLab会自动解析）
• TLS相关变量：docker:dind默认启用TLS，需配置证书路径和验证开关以确保安全连接

2. 修正基础Dockerfile #

删除错误的VOLUME指令，GitLab CI中通过服务和环境变量即可实现Docker CLI与守护进程的连接：

FROM node:20.10.0-alpine3.19

# installing essential environment
RUN apk add zip git docker-cli bash

# also installing angular
RUN npm install -g @angular/cli@15.2.10 # may not be needed

# installing ssh
RUN command -v ssh-agent >/dev/null || ( apk add --no-cache openssh )

# 删除下方错误的VOLUME指令
# VOLUME "/var/run/docker.sock:/var/run/docker.sock"

3. 可选：确保版本兼容性 #

若基础镜像的Docker CLI版本与docker:dind服务版本差异过大，可能出现兼容性问题，建议显式指定匹配的docker:dind版本：

services:
  - docker:24.0.6-dind

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