代码质量审查工具sonarqube安装

比眉伴天荒 2022-05-15 14:52 333阅读 0赞

## 简介 ##

SonarQube为静态代码检查工具，采用B/S架构，帮助检查代码缺陷，改善代码质量，提高开发速度，通过插件形式，可以支持Java、C、C++、JavaScripe等等二十几种编程语言的代码质量管理与检测。

通过客户端插件分析源代码，sonar客户端可以采用IDE插件、Sonar-Scanner插件、Ant插件和Maven插件方式，并通过各种不同的分析机制对项目源代码进行分析和扫描，并把分析扫描后的结果上传到sonar的数据库，通过sonar web界面对分析结果进行管理

架构图

![在这里插入图片描述][Center]

可以从七个维度检测代码质量:

(1)复杂度分布(complexity):代码复杂度过高将难以理解  
(2) 重复代码(duplications):程序中包含大量复制、粘贴的代码而导致代码臃肿，sonar可以展示源码中重复严重的地方

(3) 单元测试统计(unit tests):统计并展示单元测试覆盖率，开发或测试可以清楚测试代码的覆盖情况  
(4) 代码规则检查(coding rules):通过Findbugs,PMD,CheckStyle等检查代码是否符合规范  
(5) 注释率(comments):若代码注释过少，特别是人员变动后，其他人接手比较难接手；若过多，又不利于阅读  
(6) 潜在的Bug(potential bugs):通过Findbugs,PMD,CheckStyle等检测潜在的bug

(7) 结构与设计(architecture & design):找出循环，展示包与包、类与类之间的依赖、检查程序之间耦合度

## 准备工作 ##

JDK1.8需要安装和环境变量  
mysql数据库：安装方式如下  
[https://blog.csdn.net/zjcjava/article/details/78037276][https_blog.csdn.net_zjcjava_article_details_78037276]

## sonar安装 ##

下载安装文件  
wget [https://binaries.sonarsource.com/Distribution/sonarqube/sonarqube-7.3.zip][https_binaries.sonarsource.com_Distribution_sonarqube_sonarqube-7.3.zip]

创建数据库sonar，和用户密码，并授权

CREATE DATABASE sonar CHARACTER SET utf8 COLLATE utf8_general_ci; 
    CREATE USER 'sonar' IDENTIFIED BY 'sonar';
    GRANT ALL ON sonar.* TO 'sonar'@'%' IDENTIFIED BY 'sonar';
    GRANT ALL ON sonar.* TO 'sonar'@'localhost' IDENTIFIED BY 'sonar';
    FLUSH PRIVILEGES;

### 修改配置文件 ###

sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance&useSSL=false
    sonar.jdbc.username=sonar
    sonar.jdbc.password=sonar
    
    sonar.web.port=9000
    sonar.search.port=9001

注意这里的端口我修改了，web端口是9000，es的端口是9001

### WIN系统启动服务 ###

CMD命令行下执行，初始化创建数据库和启动es等服务  
E:\\sonarqube-7.3\\bin\\windows-x86-64>StartSonar.bat

主要端口不要被占用，如果占用请关闭。  
cmd查看端口占用

netstat -aon|findstr "9000"

centos利用netstat -tpnl查看的端口开放情况

### centos系统启动服务 ###

不能用root用户启动es  
创建sonar 用户并赋权

[root@i-vzdytl5t linux-x86-64]# adduser sonar
    [root@i-vzdytl5t linux-x86-64]# passwd sonar
    [root@i-vzdytl5t sonarqube]# chown -R sonar:sonar  sonarqube-7.3

然后启动服务

[root@i-vzdytl5t linux-x86-64]# su sonarUser
    [sonarUser@i-vzdytl5t linux-x86-64]$ ./sonar.sh console
    //后台启动
    [sonarUser@i-vzdytl5t linux-x86-64]$ ./sonar.sh start
    Starting SonarQube...
    Started SonarQube.
    
    [sonarUser@i-vzdytl5t linux-x86-64]$ netstat -tlnp

\#./sonar.sh start 启动服务  
\#./sonar.sh stop 停止服务  
\#./sonar.sh restart 重启服务

### 浏览器打开web服务安装插件 ###

[http://localhost:9000/projects][http_localhost_9000_projects]  
默认管理账号和密码都是admin

汉化插件安装  
直接访问下面的地址，就可以看到，列表中有Chinese Pack，  
点击Install安装，安装完成后菜单栏下方会提示你重启，点击重启即可  
[http://localhost:9457/admin/marketplace?search=Chinese][http_localhost_9457_admin_marketplace_search_Chinese]

Checkstyle 插件安装  
admin 登录，点击 配置 -> 系统 -> 更新中心 -> Available -> Search，输入 CheckStyle，在搜素结果中找到 CheckStyle 插件点击 Install，等待下载完成后，按照页面提示点击 Restart 自动重启服务即可完成安装。

## 代码检测 ##

代码检测需要客户端把检测的报告提交到服务中去  
前面已经说了客户端可以通过IDE插件、Sonar-Scanner插件、Ant插件和Maven插件方式进行扫描分析

### maven 插件方式 ###

在安装maven后的setting.xml文件的profiles标签下面贴如下配置信息

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

进入该java项目根目录 执行如下命令，最后BUILD SUCCESS则检测成功完成

>mvn clean install sonar:sonar

### Scanner安装 ###

参照资料：[https://blog.csdn.net/songer\_xing/article/details/76687225][https_blog.csdn.net_songer_xing_article_details_76687225]

下载Scanner  
[https://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner][https_docs.sonarqube.org_display_SCAN_Analyzing_with_SonarQube_Scanner]

1.解压后，打开sonar-scanner-2.8目录下的conf目录，找到sonar-scanner.properties文件

#----- Default SonarQube server
    sonar.host.url=http://localhost:9000
    
    #----- Default source code encoding
    sonar.sourceEncoding=UTF-8

2.命令查看是否可用，配置环境变量  
配置环境配量  
Windows下新增一个变量SONAR-RUNNER，值为sonar-scanner的解缩地址，  
如E:\\Program File\\sonar-scanner-2.8  
然后在PATH变量后面追加%SONAR-RUNNER%\\bin;

centos下直接在/etc/profile下参考jdk的方式

sonar-scanner -v

测试源码分析

1、配置sonar-project.properties

在要进行代码质量检测的项目根目录下新建一个名为sonar-project.properties的配置文件

# 项目唯一标识符key
    sonar.projectKey=com.demo             
    # 项目名称
    sonar.projectName=demo          
    #  项目版本
    sonar.projectVersion=1.0               
    
    # //分析的代码文件目录
    sonar.sources=src                          
    sonar.sourceEncoding=UTF-8

2.cd进入你的工作空间，某个工程的代码路径，  
3、敲入sonar-scanner，即可进行分析

[Center]: /images/20220503/0273ac9a041343f6b0ac5a202a01c0f7.png
[https_blog.csdn.net_zjcjava_article_details_78037276]: https://blog.csdn.net/zjcjava/article/details/78037276
[https_binaries.sonarsource.com_Distribution_sonarqube_sonarqube-7.3.zip]: https://binaries.sonarsource.com/Distribution/sonarqube/sonarqube-7.3.zip
[http_localhost_9000_projects]: http://localhost:9000/projects
[http_localhost_9457_admin_marketplace_search_Chinese]: http://localhost:9457/admin/marketplace?search=Chinese
[https_blog.csdn.net_songer_xing_article_details_76687225]: https://blog.csdn.net/songer_xing/article/details/76687225
[https_docs.sonarqube.org_display_SCAN_Analyzing_with_SonarQube_Scanner]: https://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner