配置sonar和jenkins进行代码审查

author author     2022-08-12     547

关键词:

转自:  http://www.cnblogs.com/gao241/p/3190701.html, 版权归原作者所有。

本文以CentOS操作系统为例介绍Sonar的安装配置,以及如何与Jenkins进行集成,通过pmd-cpd、checkstyle、findbugs等工具对代码进行持续审查。

一、安装配置sonar

1、Sonar介绍

Sonar是一个用于代码质量管理的开源平台,用于管理Java源代码的质量。通过插件机制,Sonar 可以集成不同的测试工具,代码分析工具,以及持续集成工具,比如pmd-cpd、checkstyle、findbugs、Jenkins。通过不同的插件对这些结果进行再加工处理,通过量化的方式度量代码质量的变化,从而可以方便地对不同规模和种类的工程进行代码质量管理。

同时 Sonar 还对大量的持续集成工具提供了接口支持,可以很方便地在持续集成中使用 Sonar。

此外,Sonar 的插件还可以对 Java 以外的其他编程语言提供支持,对国际化以及报告文档化也有良好的支持。

2、配置数据库

Apache Derby 是Sonar自带并且默认安装使用的数据库,此外Sonar对如下数据库提供支持:MySQL 5.x, Oracle 10g XE, Postgresql, MS SqlServer等,本文以mysql为例介绍如何配置数据库: 

1)创建数据库

在mysql中执行如下脚本创建数据库及mysql用户

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;

2)编辑${SONAR_HOME}/conf/sonar.properties配置数据库:

技术分享
技术分享
sonar.jdbc.username:                       sonar
sonar.jdbc.password:                       sonar
sonar.jdbc.url:                            jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true

# Optional properties
sonar.jdbc.driverClassName:                com.mysql.jdbc.Driver
技术分享
技术分享

3)配置DB驱动包

如果使用Oracle数据库,必须手动复制驱动类到${SONAR_HOME}/extensions/jdbc-driver/oracle/目录下。其它支持的数据库默认提供了驱动,http://docs.codehaus.org/display/SONAR/Analysis+Parameters 列举了一些常用的配置及默认值.

4)常见错误及解决方法

添加语言包后,启动报错分析:

下载安装 sonar-l10n-zh-plugin-1.4.jar 语言包(http://docs.codehaus.org/display/SONAR/Chinese+Pack),重新打包部署后,后台报错如下:

Error in Sonar.log : 2012.10.25 14:39:15 INFO org.sonar.INFO Register rules [squid/java]...2012.10.25 14:39:15 ERROR o.s.s.p.Platform The following rule (repository: squid) must have a description: Rule[id=<null>,name=<null>,key=ParsingError,configKey=ParsingError,plugin=squid,enabled=true,severity=MAJOR,cardinality=SINGLE]org.sonar.api.utils.SonarException: The following rule (repository: squid) must have a description: Rule[id=<null>,name=<null>,key=ParsingError,configKey=ParsingError,plugin=squid,enabled=true,severity=MAJOR,cardinality=SINGLE]at org.sonar.server.startup.RegisterRules.validateRule(RegisterRules.java:131) ~[classes/:na]at org.sonar.server.startup.RegisterRules.registerRepository(RegisterRules.java:103) ~[classes/:na]at...

(可参考http://jira.codehaus.org/browse/SONAR-3910)

解决方法:将 extensions\plugins\ 目录下的jar包全部删除,重新加入本地语言包后,重新打包部署即可。

3、安装、配置Sonar

Sonar的运行需要 JDK 1.5+ , 从 http://www.sonarqube.org/downloads/ 下载sonar zip文件,本文以3.6版本为例。

创建运行sonar的CentOS账户sonar,并设置账户密码:

# useradd sonar
# passwd sonar

使用sonar账户登录CentOS。

Sonar默认集成了jetty容器,可以直接启动提供服务,也可以通过脚本构建为war包,部署在tomcat容器中。

1)直接启动

编辑.bash_profile,添加环境变量SONAR_HOME

$ vi $HOME/.bash_profile

修改成如下内容:

PATH=$PATH:$HOME/bin
SONAR_HOME=$HOME/sonar

export PATH SONAR_HOME

使环境变量生效

Source $HOME/.bash_profile

运行如下命令启动sonar,其它操作系统sonar均提供了启动脚本

$ ${SONAR_HOME}/bin/linux-x86-64/sonar.sh start

在浏览器中访问: http://localhost:9000/ ,运行界面如下:

技术分享 

Sonar默认的端口是”9000”、默认的上下文路径是”/”、默认的网络接口是”0.0.0.0”,默认的管理员帐号和密码为:admin/admin,这些参数都可以在配置文件中修改:

$ vi ${SONAR_HOME}/conf/sonar.properties

技术分享

2)作为Web项目,部署到Tomcat等应用服务器中

a. 确保conf/sonar.properties、conf/wrapper.conf未被修改使用过

b. 执行如下命令生成war包,将生成的sonar.war部署到应用服务器中

$ ${SONAR_HOME}/war/build-war.sh

c. 启动Tomcat, 通过 http://localhost:8080/sonar 访问.

Tomcat安装配置参见:CenOS系统中安装Tomcat7并设置为自启动服务 

4、配置为自启动服务

使用root账户或者开启sudo权限操作。

创建自启动脚本文件/etc/init.d/sonar

# vi /etc/init.d/sonar

添加如下内容

技术分享
技术分享
#!/bin/sh
#
# rc file for SonarQube
#
# chkconfig: 345 96 10
# description: SonarQube system (www.sonarsource.org)
#
### BEGIN INIT INFO
# Provides: sonar
# Required-Start: $network
# Required-Stop: $network
# Default-Start: 3 4 5
# Default-Stop: 0 1 2 6
# Short-Description: SonarQube system (www.sonarsource.org)
# Description: SonarQube system (www.sonarsource.org)
### END INIT INFO

/usr/bin/sonar $*
技术分享
技术分享

添加启动服务

# ln -s $SONAR_HOME/bin/linux-x86-64/sonar.sh /usr/bin/sonar
# chmod 755 /etc/init.d/sonar
# chkconfig --add sonar

5、配置插件

a)插件介绍

Sonar支持多种插件,插件的下载地址为:http://docs.codehaus.org/display/SONAR/Plugin+Library

将下载后的插件上传到${SONAR_HOME}extensions\plugins目录下,重新启动sonar。

sonar默认集成了Java Ecosystem插件,该插件是一组插件的合集

  • Java [sonar-java-plugin]:java源代码解析,计算指标等
  • Squid [sonar-squid-java-plugin]:检查违反Sonar定义规则的代码
  • Checkstyle [sonar-checkstyle-plugin]:使用CheckStyle检查违反统一代码编写风格的代码
  • FindBugs [sonar-findbugs-plugin]:使用FindBugs检查违反规则的缺陷代码
  • PMD [sonar-pmd-plugin]:使用pmd检查违反规则的代码
  • Surefire [sonar-surefire-plugin]:使用Surefire执行单元测试
  • Cobertura [sonar-cobertura-plugin]:使用Cobertura获取代码覆盖率
  • JaCoCo [sonar-jacoco-plugin]:使用JaCOCO获取代码覆盖率

下面列出了一些常用的插件:

b)插件配置示例(本段内容来自http://www.ibm.com/developerworks/cn/java/j-lo-sonar/

Sonar 的主要特色是对不同工具产生的检查结果进行再加工处理,Sonar 还向用户提供了对数据进行个性化处理的方法。

本节以 Technical Debt 插件为例说明如何通过设置参数影响最后的报告结果。首先了解一下这个插件中的“技术债务”的概念,这个概念最早是在 1992 年由 Ward Cunningham 在他的论文“The WyCash Portfolio Management System”中提出的,之后被软件工程界接受并推广,《重构》的作者 Martin Fowler 也在其 网站上对技术债务有所介绍。其实原理可以理解为“出来混早晚要还的”,当前不规范的代码,会对以后产品修改的成本造成影响。

Soanr 的 Technical Debt 插件提供了默认的计算公式,通过对其中的权重参数进行配置,可以适应不同公司和项目对技术债务的计算。

技术分享 

以上的各项数据指标,可以根据自己公司和项目的不同情况进行设置,如图所示:

技术分享

例如默认参数下同一个项目的技术债务指标如下:

技术分享

修改了参数后的结果为:

技术分享

可见将 Average time to cover complexity of one (in hours) 从 0.2 修改为 0.01 后,Coverage 的权重变小了,从而达到忽略单元测试覆盖率的作用。不同的公司和项目可以根据需要调整各自的参数,参数的调优和策略不在本文的讨论范围之内。

通过以上的示例可以看出,Sonar 使用不同类型的图表显示给用户代码质量的结果,并且这些图表不是简单地对单元测试覆盖率或者静态检测工具的结果进行显示,而是根据软件工程理论进行了二次加工后的结果,更加科学和直观。

c)更新中心

以管理员用户登录Sonar,进入配置->系统,选择更新中心,如图:

技术分享

其中Available Plugins选项卡提供了可以选择安装的插件,System Updates可以在线更新Sonar。

下载插件需要注意其中有些插件是需要购买才能使用的,其License类型为Commercial。

 

二、与jenkins集成

1、通过Maven进行集成

修改maven的主配置文件(${MAVEN_HOME}/conf/settings.xml文件或者 ~/.m2/settings.xml文件),在其中增加访问Sonar数据库及Sonar服务地址,添加如下配置:

技术分享
技术分享
<profile>

<id>sonar</id>

<properties>

    <sonar.jdbc.url>jdbc:mysql://localhost:3306/sonar</sonar.jdbc.url>

    <sonar.jdbc.driver>com.mysql.jdbc.Driver</sonar.jdbc.driver>

    <sonar.jdbc.username>sonar</sonar.jdbc.username>

    <sonar.jdbc.password>sonar</sonar.jdbc.password>

    <sonar.host.url>http://localhost:9000</sonar.host.url> <!-- Sonar服务器访问地址 -->

</properties>

</profile>

<activeProfiles>

  <activeProfile>sonar</activeProfile>

</activeProfiles>
技术分享
技术分享

此处注意sonar.host.url地址应根据sonar部署情况修改

同样,为了避免内存溢出,推荐增加内存堆栈的大小。设置MAVEN_OPTS环境变量:

set MAVEN_OPTS=”-Xmx512m -XX:MaxPermSize=256m”  

使用Sonar

a. 运行Sonar服务器;

b. 通过 mvn sonar:sonar 将代码注入到Sonar中进行分析处理,并将处理结果以XML的形式保存在数据库中;

c. 通过浏览器访问,显示分析结果;

d. 持续运行Maven构建,会迭代显示分析结果;

e. 可以显式指定sonar插件的版本,如下:

技术分享
技术分享
        <project>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.codehaus.sonar</groupId>
                        <artifactId>sonar-maven-plugin</artifactId>
                        <version>3.5.1</version>
                    </plugin>
                </plugins>
            </build>
        </project> 
技术分享
技术分享

f. 可以显式的将sonar绑定到Maven生命周期中,如下: 

技术分享
技术分享
        <plugin>  
            <groupId>org.codehaus.sonar</groupId>
            <artifactId>sonar-maven-plugin</artifactId>
            <version>3.5.1</version>
            <executions>
                <execution>
                    <id>sonar</id>
                    <phase>site</phase>
                    <goals>
                    <goal>sonar</goal>
                    </goals>
                </execution>
            </executions>
      </plugin>
技术分享
技术分享

此时,指定Maven的site声明周期时,则会自动调用sonar.sonar 命令.

2、直接与Jenkins集成

在jenkins的插件管理中选择安装sonar jenkins plugin,该插件可以使项目每次构建都调用sonar进行代码度量。

进入配置页面对sonar插件进行配置,如下图:

技术分享

配置构建项目,增加Post Build Action:

技术分享

 

技术分享

应用程序构建时就会自动触发Sonar对代码的检查

技术分享

配置sonarjenkins进行持续审查

.../gao241/p/3190701.html本文以CentOS操作系统为例介绍Sonar的安装配置,以及如何与Jenkins进行集成,通过pmd-cpd、checkstyle、findbugs等工具对代码进行持续审查。一、安装配置sonar1、Sonar介绍Sonar是一个用于代码质量管理的开源平台,用于管... 查看详情

sonar安装配置

本文以CentOS操作系统为例介绍Sonar的安装配置,以及如何与Jenkins进行集成,通过pmd-cpd、checkstyle、findbugs等工具对代码进行持续审查。一、安装配置sonar1、Sonar介绍Sonar是一个用于代码质量管理的开源平台,用于管理Java源代码的质... 查看详情

jenkins+gradle+sonar进行java项目代码分析

Jenkins+Maven+Sonar与Jenkins+Gradle+Sonar配置方法很相似,区别就是Java项目所用的编译工具不同,一个是maven,一个是gradle使用maven编译工具的可参考Sonar+maven+jenkins集成,Java代码走查 https://www.cnblogs.com/chenchen-tester/p/7269828.html使用gradl... 查看详情

配置sonarqube_jenkins进行持续java代码自动构建审查

本文以CentOS操作系统为例介绍SonarQube的安装配置,以及如何与Jenkins进行集成   服务器环境:         [[email protected]data]#uname -a     &n 查看详情

jenkins中部署sonar代码检查

...,然后生成Tokens这个Tokens用于和Jenkins进行交互2在Jenkins中配置SonarQube服务器(1)安装SonarQubeScannerforJenkins插件;(2)系统管理->系统设置,配置SonarQube服务器Name随便命名,Job中需要用到;ServerURL填之前安装的SonarQube服务的URL;Servera... 查看详情

jenkins集成sonarqube实现代码质量检查(代码片段)

...ver:WebServer:供开发人员,管理人员浏览高质量的快照并配置SonarQube实例SearchServer:基于Elasticsearch的SearchServer从UI进行后退搜索(历史)computeEngine:负责处理代码分析报告并将其保存在SonarQube数据库中2.SonarQubeDatabase:SonarQube实例... 查看详情

sonar+jenkins代码覆盖率检测

...资料网上比较多,大家查阅一下就可以了一、项目中需要配置信息:     1.在maven的pom文件中添加插件: &nbs 查看详情

如何使用sonarqube与jenkins

参考技术A只需要把sonar信息配置在mavenconfsettings.xml里面的里,如sonarhttp://ip:9000jdbc:h2:tcp://ip:9092/sonarorg.h2.Driversonarsonarsonar,并默认激活。再在jenkins里面配置命令cleantestsonar:sonar-Dsonar.forceAnalysis=true... 参考技术B你问的范围太广了,... 查看详情

利用jenkins和sonarqube集成对代码进行持续检测

Jenkins与SonarQube集成插件的安装与配置Jenkins是一个支持自动化框架的服务器,我们这里不做详细介绍。Jenkins提供了相关的插件,使得SonarQube可以很容易地集成,登陆jenkins,点击"ManageJenkins",选择“MangePlugins”点击“Avzilab... 查看详情

持续集成之代码质量管理———sonar(代码片段)

...法的建议。所以称之为质量管理。一、部署Sonar接下来的配置是基于博文部署Jenkins+Gitlab实现持续集成的环境进行部署所有的源码包及插件都可以在此链接(提取码:t976)下载[root@jenkins~]#unzipsonarqube-5.6.zip[root@jenkins~]#mvsonarqube-5.6//u 查看详情

jenkins集成sonar代码质量扫描

...ins插件安装界面安装:插件名SonarQubeScannerforJenkinsJenkins上配置jenkins中操作:系统管理-系统设置,找到SonarQubeservers部分,填写如下jenkins中操作:系统管理-全局工具配置找到SonarQubeScanner部分,填写如下选择自己的项目(ces)-构... 查看详情

jenkins+sonarqube代码审查(代码片段)

...查概述Jenkins安装SonarQubeScanner插件安装SonarQubeScannerJenkins配置SonarServer非流水线项目添加SonarQube代码审查流水线项目添加SonarQube代码审查引言SonarQube是一个用于管理代码质量的开放平台,可 查看详情

jenkins持续集成构建

配置Sonar、Jenkins进行持续审查http://go2live.cn/archives/38261.htmlJenkinsiOS项目持续集成http://go2live.cn/archives/23173.html用Jenkins搭建Android自动打包环境http://go2live.cn/archives/32350.html使用的项目:Manven Grandle。。。W 查看详情

jenkins——jenkins+sonarqube代码审查(代码片段)

...码审查安装SonarQube安装MySQL安装SonarQube实现代码审查环境配置在项目添加SonaQube代码审查(非流水线项目)在项目添加SonaQube代码审查(流水线项目)SonarQube是一个用于管理代码质量的开放平台,可以快速的定... 查看详情

jenkins——jenkins+sonarqube代码审查(代码片段)

...码审查安装SonarQube安装MySQL安装SonarQube实现代码审查环境配置在项目添加SonaQube代码审查(非流水线项目)在项目添加SonaQube代码审查(流水线项目)SonarQube是一个用于管理代码质量的开放平台,可以快速的定... 查看详情

jenkins集成sonar问题记录(代码片段)

...4;这个插件,插件安装完了之后,需要进行工具的配置,这个配置路径是"系统管理-》全局工具配置-》SonarQubeScanner"。在这个配置中,需要制定一个sonar的客户端程序,可以直接在jenkins的页面上选择安装,... 查看详情

jenkins集成sonarqube实现代码质量检查

​一、SonarQube简介   SonarQube是一个开源平台,用于管理源代码的质量。Sonar不只是一个质量数据报告工具,更是代码质量管理平台。支持Java、Python、C、C++、Go等多种语言。   SonarQube是一种自动代码审查工具... 查看详情

jenkins和sonar集成

 Jenkins可以通过插件的形式和Sonar很好的集成。  (1)Jenkin安装Sonar插件(这里我估计安装的插件有点多)        注意:之前安装Jenkins的时候我用的是JDK系统环境环境变量jdk1.7,在安装sonar插件的时候会出现JDK版本过低... 查看详情