You need to enable JavaScript to run this app. GitLab Runner docker执行器无法运行docker命令问题排查求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 10:03:03