grunya404/gitlab-sonar-scanner

gitlab-sonar-scanner镜像

镜像概述

该镜像为GitLab项目提供Sonar扫描能力，集成gitlab-sonar-scanner v3.2、Python 3.6、pylint及JDK10支持，可与Sonar GitLab插件配合使用，实现代码质量分析与结果反馈。

核心功能

1. 支持两种分析模式：issues（在GitLab中发布代码问题评论）和publish（将分析报告发送至SonarQube服务器）；
2. 通过环境变量配置Sonar服务器地址、项目版本、源代码路径等参数；
3. 允许传递自定义sonar-scanner选项；
4. 集成Python 3.6与pylint，支持Python代码质量检查。

使用场景

适用于GitLab CI/CD流程中的代码分析阶段，帮助团队自动检测代码问题、提升代码质量，并将结果同步至SonarQube或直接在GitLab中展示。

配置说明

1. GitLab CI配置示例

在.gitlab-ci.yml中添加分析阶段：

yaml
stages:
- analysis

sonarqube:
  stage: analysis
  image: docker.xuanyuan.run/grunya404/gitlab-sonar-scanner
  variables:
    SONAR_URL: http://your.sonarqube.server
    SONAR_ANALYSIS_MODE: issues
  script:
  - gitlab-sonar-scanner

sonarqube-reports:
  stage: analysis
  image: docker.xuanyuan.run/grunya404/gitlab-sonar-scanner
  variables:
    SONAR_URL: http://your.sonarqube.server
    SONAR_ANALYSIS_MODE: publish
  script:
  - gitlab-sonar-scanner

2. sonar-project.properties文件

项目根目录需创建该文件，示例：

conf
sonar.projectKey=your-project-key
sonar.exclusions=node_modules/**,coverage/**
sonar.sources=.
sonar.gitlab.project_id=git@your-git-repo.git

3. 主要环境变量

• SONAR_URL：SonarQube服务器地址；
• SONAR_PROJECT_VERSION：项目版本；
• SONAR_SOURCES：源代码路径；
• SONAR_ANALYSIS_MODE：分析模式（issues/publish）；
• SONAR_GITLAB_PROJECT_ID：GitLab项目ID或仓库URL。

4. 自定义参数示例

传递额外sonar-scanner选项：

yaml
sonarqube-reports:
  image: docker.xuanyuan.run/grunya404/gitlab-sonar-scanner
  variables:
    SONAR_URL: http://your.sonarqube.server
    SONAR_ANALYSIS_MODE: publish
  script:
  - gitlab-sonar-scanner -Dsonar.custom.param=value -Dsonar.another.param=another_value

5. Docker运行示例

直接运行扫描：

bash
docker run -v $(pwd):/app -e SONAR_URL=[***] -w /app docker.xuanyuan.run/grunya404/gitlab-sonar-scanner gitlab-sonar-scanner