转载

代码质量检测(SonarQube)整合中文版+阿里P3C

简介

SonarQube 是一种自动代码审查工具，用于检测代码中的错误，漏洞和代码异味。它可以与您现有的工作流程集成，以便在项目分支和拉取请求之间进行连续的代码检查。

连续代码检查,sonar可以单独使用 Maven 、 Gradle 推送代码检查，当然也可以在ci引擎进行代码自动检查，如: Jenkins 、 Git 。

服务端

安装

为了快速启动 sonarqube 实例，我们采用docker的方式。

sonarqube 默认为英文版的，检查规则为自带的，我们这里采用中文汉化，另外 java 语言加入阿里p3c 规则。

使用git克隆项目：

git clone https://github.com/purgeteam/sonarqube-start
cd docker-start

sonar-docker-start.yml 模板如下：

# 汉化版+阿里p3c验证
version: "2"

services:
  sonarqube:
    image: sonarqube
    ports:
      - "9000:9000"
    networks:
      - sonarnet
    environment:
      - sonar.jdbc.url=jdbc:postgresql://db:5432/sonar
    volumes:
      - sonarqube_conf:/opt/sonarqube/conf
      - sonarqube_data:/opt/sonarqube/data
      - sonarqube_extensions:/opt/sonarqube/extensions
      - sonarqube_bundled-plugins:/opt/sonarqube/lib/bundled-plugins
      - ./plugin/rhinoceros/sonar-pmd-plugin-3.2.0-SNAPSHOT.jar:/opt/sonarqube/extensions/plugins/sonar-pmd-plugin-3.2.0-SNAPSHOT.jar
      - ./plugin/sonar-l10n-zh-plugin-1.16.jar:/opt/sonarqube/extensions/plugins/sonar-l10n-zh-plugin-1.16.jar

  db:
    image: postgres
    ports:
      - "5432:5432"
    networks:
      - sonarnet
    environment:
      - POSTGRES_USER=sonar
      - POSTGRES_PASSWORD=sonar
    volumes:
      - ./postgres/postgresql:/var/lib/postgresql
      - ./postgres/postgresql_data:/var/lib/postgresql/data

networks:
  sonarnet:
    driver: bridge

volumes:
  sonarqube_conf:
  sonarqube_data:
  sonarqube_extensions:
  sonarqube_bundled-plugins:
  postgresql:
  postgresql_data:

使用docker-compose启动

docker-compose -d sonar-docker-start.yml up

默认会吧插件挂载进容器内部。

启动ok，查看控制台进行访问 localhost:9000 ,默认账号密码： admin/admin 。

默认规则配置

虽然已经集成了阿里P3C,但是使用的还是默认规则，这里我们需要设置为指定规则。

以admin账号登陆

代码质量检测(SonarQube)整合中文版+阿里P3C

打开质量配置 profiles 页，点击右上方的 创建 按钮，创建 p3c profiles

代码质量检测(SonarQube)整合中文版+阿里P3C

首次创建会跳转到代码规则配置页面，刚新建的 profile 是没有激活任何规则的，需要手动激活

代码质量检测(SonarQube)整合中文版+阿里P3C

我们需要为刚创建的 p3c profile 激活 p3c 规则，点击【激活更多规则】

跳转到激活页面,搜索p3c，如图，都是以 [p3c] 开头的规则。

代码质量检测(SonarQube)整合中文版+阿里P3C

批量修改->活动 p3c -> 应用 -> 成功

代码质量检测(SonarQube)整合中文版+阿里P3C

绑定规则成功后基本完成，我们返回 质量配置 ，在 java 选择刚设置的 p3c 设置为默认。

代码质量检测(SonarQube)整合中文版+阿里P3C

配置阿里P3C已经完成。

Maven代码检查

sonarqube 可以使用多种方式进行代码上传检查。

我们使用简单的 Maven 触发代码检查。

添加插件

在项目 pom 文件里添加 sonar-maven-plugin 插件。

<build>
    <plugins>

        <plugin>
            <groupId>org.sonarsource.scanner.maven</groupId>
            <artifactId>sonar-maven-plugin</artifactId>
            <version>3.6.0.1398</version>
        </plugin>

    </plugins>
</build>

服务器相关配置:

需要将 <sonar.host.url> 修改为之前搭建的 sonarqube 服务地址。

<!-- SonarQube代码质量检测 -->
<profiles>

    <profile>
        <id>sonar</id>
        <activation>
            <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
            <sonar.host.url>http://127.0.0.1:9000/</sonar.host.url>
        </properties>
    </profile>
    
</profiles>

触发检查

pom 配置完成，先将代码进行构建使用 Maven package 命令。

完成构建执行 mvn sonar:sonar 命令，也可以使用 idea maven 可视化界面进行操作。

代码质量检测(SonarQube)整合中文版+阿里P3C