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
相关产品推荐
相关产品推荐

