nexcer/docker-sonar-scanner

docker-sonar-scanner

镜像概述

docker-sonar-scanner是一个预配置了JRE环境的Sonar Scanner命令行工具镜像，可直接用于代码质量和安全性分析。该镜像已发布至Docker Hub，地址为：https://hub.docker.com/r/nexcer/docker-sonar-scanner/%E3%80%82

核心功能与特性

• 内置Sonar Scanner CLI：包含官方Sonar Scanner命令行工具，支持标准的代码扫描功能
• 集成JRE环境：无需额外安装Java运行时，可直接运行Sonar Scanner
• 轻量级设计：基于精简基础镜像，减少部署体积
• 灵活配置：支持通过环境变量或命令参数自定义扫描配置

使用场景

• CI/CD流程集成：在持续集成/持续部署管道中自动执行代码质量检查
• 本地开发验证：开发人员在本地环境快速验证代码质量
• 项目构建前置检查：作为代码合并或发布前的质量门禁环节

使用方法

基础扫描命令

通过docker run命令启动容器，挂载代码目录并指定SonarQube服务器配置：

bash
docker run --rm \
  -v $(pwd):/project \  # 挂载本地代码目录到容器内/project路径
  -e SONAR_HOST_URL="http://your-sonarqube-server:9000" \  # SonarQube服务器地址
  -e SONAR_TOKEN="your-sonar-token" \  # SonarQube访问令牌
  -e SONAR_PROJECT_KEY="your-project-key" \  # 项目唯一标识
  nexcer/docker-sonar-scanner \
  sonar-scanner -Dsonar.projectBaseDir=/project  # 指定扫描根目录

常用环境变量配置

自定义扫描参数

除环境变量外，可直接在命令中添加Sonar Scanner参数，例如指定源代码目录、排除文件等：

bash
docker run --rm \
  -v $(pwd):/project \
  -e SONAR_HOST_URL="http://sonarqube:9000" \
  -e SONAR_TOKEN="your-sonar-token" \
  nexcer/docker-sonar-scanner \
  sonar-scanner \
    -Dsonar.projectBaseDir=/project \
    -Dsonar.sources=src \  # 指定源代码目录
    -Dsonar.exclusions=**/test/**/*  # 排除测试目录

注意事项

• 确保SonarQube服务器可被容器访问（网络配置需正确）
• 挂载代码目录时，容器内路径需与sonar.projectBaseDir参数一致
• 敏感信息（如SONAR_TOKEN）建议通过环境变量注入，避免硬编码在命令中
• 扫描结果将直接发送至SONAR_HOST_URL指定的SonarQube服务器，可在服务器控制台查看详细报告