持续集成实践二之Jenkins与Sonar Qube集成

4591566

前言
　　  作为一名码农，曾几何时，无数次挑灯夜战，只为第二天为客户稳定演示系统，奈何到关键时候，会发现代码中会有很多坑，这个时候，往往是最令人崩溃的。如何能做到提前发现程序潜在的问题，找到隐藏的八阿哥，保证系统的稳定，一直是困扰着我们的问题。记得以前为了解决这个问题，部门专门组织每周一次代码走查，虽然最后情况有所改善，但费事费力，并未得到根本上的解决。
　　  所幸的是，有些大牛开发出了一系列代码质量检测工具，给我们这些码农带来了福音。下面就来介绍一款开源的代码质量管理系统——SonarQube。相信通过下面简单的介绍，你会跟我一样有种相见恨晚的感觉。

Sonar Qube简介
　　  SonarQube（曾用名Sonar（声纳））是一个开源的代码质量管理系统。它支持C/C++、JavaScript、C#、Java、COBOL、TypeScript、PL/SQL、PL/I、PHP、FLEX、Python、Swift、XML等超过20种编程语言的检测。Sonar可以通过插件Findbugs、Checkstyle等工具持续对代码进行检测，可以使我们尽早发现项目中的Bugs，漏洞及坏味道，从而保证软件产品质量。

环境准备

• 　　操作系统：Windows10
  
  
• 　　Java环境：下载 jdk-1.8.0-131-X64.zip，配置Java环境变量（参考：http://jingyan.baidu.com/article/02027811629b941bcc9ce521.html）
  
  

　　Maven环境：下载apache-maven-3.5.2-bin.zip，配置Maven环境变量（参考：http://wiki.jikexueyuan.com/project/maven/environment-setup.html）

• 　　Jenkins安装及配置，请参考上一篇文章，链接：https://my.oschina.net/lsjcoder/blog/1573648。
  
  
• 　　数据库：mysql-5.6.23-winx64
  
  

Sonar 安装

• 　　SonarQube下载。首先，到Sonar官网https://www.sonarqube.org/downloads/）下载安装包，目前最新版本为SonarQube 6.7 (LTS *)。将SonarQube解压到本地任意目录。
  
  
• 　　配置Sonar数据库。Sonar默认使用的是H2的内嵌数据库，内嵌数据库只能用户测试场景，本例中使用mysql数据库，具体配置方法如下：
  
  

　　  在mysql中创建sonar数据库，以用户名root，密码admin为例。打开...\sonarqube-6.6\conf文件夹，找到sonar.properties文件，修改以下几个地方：
　　  配置数据库用户名及密码：
　　```properties
　　
#sonar.properties
　　sonar.jdbc.username=root
　　
sonar.jdbc.password=admin
　　
```
　　  设置数据库库连接：
　　```properties
　　
#sonar.properties
　　

sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance　　
sonar.jdbc.driverClassName:com.mysql.jdbc.Driver
　　
sonar.jdbc.validationQuery:select 1
　　

　　```
　　  设置连接池：
　　```properties
　　
#sonar.properties
　　

sonar.jdbc.maxActive:                               20　　
sonar.jdbc.maxIdle:                                 5
　　
sonar.jdbc.minIdle:                                 2
　　
sonar.jdbc.maxWait:                                 5000
　　
sonar.jdbc.minEvictableIdleTimeMillis:      600000
　　
sonar.jdbc.timeBetweenEvictionRunsMillis:  30000
　　

　　```

• 启动Sonar。
  

　　  启动Sonar有两种方式：一种，直接执行...\sonarqube-6.6\bin\windows-x86-64\StartSonar.bat；另一种，将Sonar安装为Windows服务，注意一定要以管理员身份运行...\sonarqube-6.6\bin\windows-x86-64\InstallNTService.bat，安装成功以后，运行...\sonarqube-6.6\bin\windows-x86-64\StartNTService.bat启动Sonar。Sonar启动以后，在浏览器中输入地址http://localhost:9000访问Sonar主页。

• Sonar汉化。
  

　　  下载Sonar汉化插件，链接：https://github.com/SonarQubeCommunity/sonar-l10n-zh/releases/tag/sonar-l10n-zh-plugin-1.18，将汉化插件拷贝到...\sonarqube-6.6\extensions\plugins文件夹，重启Sonar。Sonar重启以后，在浏览器中输入地址http://localhost:9000访问Sonar主页。

• Sonar插件安装。
  

• 　　安装 SonarJava 插件Java代码分析器；
  
  
• 　　安装SonarJS插件，JavaScript代码分析器；
  
  
• 　　安装SonarXML插件，XML分析器；
  
  
• 　　安装Web插件，HTML, JSP, JSF, ..代码分析器；
  
  
• 　　安装CSS / SCSS / Less插件，CSS、Less代码分析器；
  
  
• 　　安装SonarC# 插件，C#代码分析器；
  
  
• 　　安装SonarQube :: Plugins :: SCM :: SVN插件；
  
  
• 　　安装Checkstyle插件，Provide Checkstyle rules for Java projects；
  
  
• 　　安装Findugs 插件，Provide Findbugs rules for analysis of Java projects。
  
  

• 配置SCM权限。
  

Scanner安装

• 下载SonarQube Scanner 3.0.3安装包（链接：https://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner）。将SonarQube Scanner 3.0.3安装包解压到任意目录。
  
• 配置SonarQube Scanner。打开...\sonar-scanner-3.0.3.778-windows\conf文件夹，找到sonar-scanner.properties并以文本编辑器打开，配置如下：
  

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

Jenkins集成

• 　　Jenkins安装。请参照上一篇文章，链接：https://my.oschina.net/lsjcoder/blog/1573648。
  
  
• 　　安装SonarQube Scanner for Jenkins插件安装。系统管理->管理插件，找到SonarQube Scanner for Jenkins插件，安装完成后重启Jenkins。
  
  

• 配置SonarQube Server。
  

• 配置SonarQube Scanner。
  

• 项目中增加SonarQube Scanner扫描配置。
  

• 立即构建，查看控制台日志输出。
  

分析结果
　　  点击上面的链接，即可打开SonarQube，查看项目分析结果。

总结
　　  在整合流程中，需要注意一下几点：

• mysql版本必须要安装5.6及以上版本，否则会导致Sonar因不兼容而无法正常运行；
  
• SonarQube未配置SCM权限，会导致报”SVNAuthenticationException“的错误；
  
• 注意一定要安装各种语言分析插件，否则会报”No quality profiles have been found, you probably don't have any language plugin installed“的错误；
  

　　  至此，Jenkins与Sonar Qube的初步集成工作已初步完成，下面就会针对自动检测出来的Bugs、漏洞及坏味道，进行逐一修复，还掉以前欠下来的技术债务。
　　欢迎关注我的微信公众号：