You need to enable JavaScript to run this app. GitLab CI中SonarScanner作业执行报docker命令未找到问题
优惠活动
大模型
产品
解决方案
定价
更多

GitLab CI中SonarScanner作业执行报docker命令未找到问题

核心报错根因
  • 当前作业使用的sonarsource/sonar-scanner-cli:latest主运行镜像,仅预装Sonar Scanner执行静态代码扫描所需的Java运行环境、扫描工具依赖,未内置Docker客户端可执行命令
  • 配置里的docker:dind是作为独立的服务容器和主作业容器并行启动的,服务容器内的可执行文件、路径不会自动注入到主作业容器的执行环境中
  • SonarQube Community 8.7.0版本的项目配置向导,自动生成的GitLab CI模板会默认内嵌一段调用docker命令的分支检测逻辑,当主作业容器找不到docker可执行文件时,就会直接触发/bin/bash: line 118: docker: command not found的报错,这段逻辑和纯代码扫描的实际需求无关。
验证排查步骤
  • 临时在作业的script块开头追加which docker命令,单独触发作业运行,如果命令返回空路径,即可确认主容器内不存在docker可执行文件
  • 检查生成的.gitlab-ci.yml中脚本块的实际内容,定位118行附近的docker命令调用,确认是模板自带的冗余逻辑而非业务扫描需要的命令
  • 核对dind服务的连通配置:即使后续在主容器安装了docker客户端,也需要保证客户端能通过正确的网络地址访问到dind服务后端,否则即使命令存在也无法正常执行。
可落地方案(按推荐优先级排序)

方案1:移除冗余的Dind配置(最优解,适配纯代码静态扫描场景)

绝大多数SonarQube代码扫描场景不需要调用Docker命令,直接移除模板自动生成的冗余dind相关配置即可解决问题,零额外成本:

  • 删除作业配置中整个services: - docker:dind配置块
  • 清理脚本块中所有和docker相关的冗余调用,仅保留核心的sonar-scanner执行命令
  • 调整后的有效配置参考:
sonarqube-check:
  image: 
    name: sonarsource/sonar-scanner-cli:latest
    entrypoint: [""]
  variables:
    SONAR_USER_HOME: "${CI_PROJECT_DIR}/.sonar"  # 定义分析任务缓存目录
    GIT_DEPTH: "0"  # 拉取全量分支信息满足扫描要求
    SONAR_HOST_URL: ${SONAR_HOST_URL}
    SONAR_TOKEN: ${SONAR_TOKEN}
  cache:
    key: "${CI_JOB_NAME}"
    paths:
      - .sonar/cache
  script: 
    - sonar-scanner
  allow_failure: true
  only:
    - master

方案2:补全主容器的Docker客户端(适配需要执行Docker命令的特殊扫描场景)

如果业务场景确实需要在扫描作业里调用docker命令(比如容器镜像漏洞扫描、构建阶段的镜像操作),需要在主容器内安装docker客户端,不能依赖dind服务自带的可执行文件:

  • 在variables块中追加dind的连通配置:DOCKER_HOST: tcp://docker:2375/,让客户端能正常访问并行启动的dind服务
  • 在script块的最开头追加适配sonar-scanner-cli镜像(Alpine基础环境)的安装命令:apk add --no-cache docker-cli
  • 保留原有services: - docker:dind、特权模式的dind配置即可

方案3:替换预装好依赖的基础镜像

如果不想每次作业启动都临时安装docker-cli,可以直接选用同时内置Sonar Scanner、Docker客户端的基础镜像作为作业运行环境,跳过临时安装步骤,缩短作业执行时长。

内容的提问来源于stack exchange,提问作者Zeeshan

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.01 01:54:04