持续集成实践二之Jenkins与Sonar Qube集成
前言作为一名码农，曾几何时，无数次挑灯夜战，只为第二天为客户稳定演示系统，奈何到关键时候，会发现代码中会有很多坑，这个时候，往往是最令人崩溃的。如何能做到提前发现程序潜在的问题，找到隐藏的八阿哥，保证系统的稳定，一直是困扰着我们的问题。记得以前为了解决这个问题，部门专门组织每周一次代码走查，虽然最后情况有所改善，但费事费力，并未得到根本上的解决。
所幸的是，有些大牛开发出了一系列代码质量检测工具，给我们这些码农带来了福音。下面就来介绍一款开源的代码质量管理系统——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主页。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/Sonar%E5%90%AF%E5%8A%A8%E7%95%8C%E9%9D%A2.png
[*]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主页。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/sonarQube%E6%B1%89%E5%8C%96%E4%B8%BB%E9%A1%B5.png
[*]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权限。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/%E9%85%8D%E7%BD%AESCM%E6%9D%83%E9%99%90.png
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。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/SonarQube%20for%20Jenkins%E6%8F%92%E4%BB%B6%E5%AE%89%E8%A3%85.png
[*]配置SonarQube Server。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/%E9%85%8D%E7%BD%AESonarQube%20Server.png
[*]配置SonarQube Scanner。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/%E9%85%8D%E7%BD%AESonarQube%20Scanner.png
[*]项目中增加SonarQube Scanner扫描配置。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/%E6%B7%BB%E5%8A%A0Postbuildstep.png
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/%E9%A1%B9%E7%9B%AE%E9%85%8D%E7%BD%AE.png
[*]立即构建，查看控制台日志输出。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/%E5%88%86%E6%9E%90%E7%BB%93%E6%9E%9C.png
分析结果
点击上面的链接，即可打开SonarQube，查看项目分析结果。
https://gitee.com/lsjcoder/img/raw/master/%E4%BB%A3%E7%A0%81%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7/%E7%BB%93%E6%9E%9C%E6%B5%8F%E8%A7%88.png
总结
在整合流程中，需要注意一下几点：
[*]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、漏洞及坏味道，进行逐一修复，还掉以前欠下来的技术债务。
欢迎关注我的微信公众号：
https://gitee.com/lsjcoder/img/raw/master/other/1.jpg
页:
[1]