GitLab Runner docker执行器无法运行docker命令问题排查求助
根因分析
你的配置核心矛盾点:
- CI运行日志明确显示使用的是
kubernetes执行器,但你在values.yaml中配置的是docker执行器的参数,所有Docker执行器下的socket挂载、权限配置对Kubernetes执行器完全不生效,导致CI Job容器内根本没有挂载宿主机的/var/run/docker.sock,自然无法连接Docker daemon。
解决方案
步骤1:修正GitLab Runner的values.yaml配置
替换原有配置为Kubernetes执行器的正确配置,示例如下:
config: | [[runners]] url = "https://gitlab.com/" executor = "kubernetes" [runners.kubernetes] image = "docker:19.03.12" privileged = true # 配置宿主机docker.sock挂载 [[runners.kubernetes.volumes.host_path]] name = "docker-sock" mount_path = "/var/run/docker.sock" host_path = "/var/run/docker.sock" read_only = false [[runners.kubernetes.volumes.host_path]] name = "cache" mount_path = "/cache" host_path = "/cache"
修改完成后重新升级安装GitLab Runner Helm包生效。
步骤2:验证集群节点Docker环境
登录Kubernetes集群的工作节点,执行以下命令确认Docker socket存在:
ls /var/run/docker.sock
如果返回文件不存在,说明你的集群使用的是containerd等其他容器运行时,没有Docker服务,可选择两种方案:
- 方案1:将节点运行时替换为Docker
- 方案2:改用DinD sidecar模式运行Docker命令,无需依赖宿主机Docker环境
步骤3:可选优化CI配置
可在.gitlab-ci.yml的variables块中显式指定Docker socket路径,避免默认值异常:
variables: DOCKER_DRIVER: overlay2 DOCKER_HOST: unix:///var/run/docker.sock
注意事项
直接挂载宿主机Docker socket会赋予CI Job容器宿主机的root权限,存在较高安全风险,该Runner仅建议分配给内部可信项目使用。
内容的提问来源于stack exchange,提问作者Heapify
相关产品推荐
相关产品推荐

