Jenkins+sonar+tomcat+SVN集成搭建

一、 文档说明

本文档用于说明Jenkins+tomcat+sonar+SVN集成分析代码的搭建过程和可能遇到的问题及问题的相关解决办法；本文档针对内部人员公开，搭建过程中一些工作是为远程访问Jenkins、sonar而做，若是在本地服务器搭建则不需要做相关工作；Jenkins和sonar的搭建环境为Linux、mysql、jdk1.7、jenkins、sonar4.5等，相关的版本说明会在后续文档中详细描述。

二、 jdk1.7安装

1、 准备jdk安装包

去官方网站选择你需要的版本，下载rpm包，http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html ；

2、 安装jdk

（1）安装rpm包，命令：rpm -ivh jdk-6u45-linux-amd64.rpm

（2）配置JDK环境变量：

a.[root@localhost tools]# vim $HOME/.bash_profile
b.添加下面信息：
#Java Profile

export JAVA_HOME=/usr/java/jdk1.6.0_45 （按照自己的真实目录）
export CLASSPATH=.:$JAVA_HOME/jre/lib/rt.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

export PATH=$PATH:$JAVA_HOME/bin
c.保存退出；

d.使环境变量生效：[root@localhost tools]#source /etc/profile

e.检测jdk是否安装成功：[root@localhost tools]# echo $JAVA_HOME
/usr/java/jdk1.6.0_45（显示这一行内容表示安装成功）

或者：[root@localhost tools]# java –version

输入上述命令会下显示jdk的版本，表示安装成功

三、 sonar安装与配置

1、 安装sonar

（1）Sonar介绍

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

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

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

（2）下载软件：wget http://dist.sonar.codehaus.org/sonar-3.7.4.zip
（3）解压软件：unzip sonar-3.7.4.zip

（4）配置数据库

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

这里首先需要配置数据库信息：
前提是你已经安装了mysql数据库，这里将不做数据库安装的介绍；

登录数据库命令：mysql –uroot -p
mysql> CREATE DATABASE sonar CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> grant all on sonar.* to sonar identified by 'sonar';
mysql> grant all on sonar.* to sonar@'192.168.5.105' identified by 'sonar';
mysql> flush privileges;

2、 sonar环境配置

（1）配置文件修改

[root@localhostdata]# vim home/dev/sonar-3.7.4/conf/sonar.properties

（这里为sonar的安装路径下的conf文件夹里面的sonar.properties）
修改如下字段（就是配置数据库信息，其他不用动）：

# User credentials.

# Permissions to create tables, indices and triggers must be granted to JDBC user.

# The schema must be created first.

sonar.jdbc.username=root

sonar.jdbc.password=123456（这里为链接数据库的用户名和密码）

#----- Embedded Database (default)

# It does not accept connections from remote hosts, so the

# server and the analyzers must be executed on the same host.

#sonar.jdbc.url=jdbc:h2:tcp://localhost:9092/sonar

# H2 embedded database server listening port, defaults to 9092

#sonar.embeddedDatabase.port=9092

#----- MySQL 5.x

sonar.jdbc.url=jdbc:mysql://192.168.5.105:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance

（备注：sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar若是远程部署，链接数据库的地址建议写为IP地址，有时系统不能解析localhost，以防出错）

# By default, ports will be used on all IP addresses associated with the server.

sonar.web.host=192.168.5.105（IP地址）

# Web context. When set, it must start with forward slash (for example /sonarqube).

# The default value is root context (empty value).

sonar.web.context=/sonar（默认为“/”，也可以写成“/sonar”;若是“/”，访问时用IP加端口号就可以访问了，若是写成“/sonar”，访问时需在端口号后面加上“/sonar”）

# TCP port for incoming HTTP connections. Disabled when value is -1.

sonar.web.port=9001（访问端口号）
（2）启动sonar

编辑.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

或者在bin/ linux-x86-64/下执行 ./ sonar.sh

在浏览器中访问: http://localhost:9001/sonar （上下文默认为“/”，上面配置文件中修改为“/sonar”，访问时就加上“/sonar”），运行界面如下：

四、 sonar-runner安装与配置

1、 sonar-runner的安装

sonar-runner的安装与sonar一致；先下载安装包，然后解压安装包，再添加环境变量

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

$ vi $HOME/.bash_profile

修改成如下内容：

PATH=$PATH:$HOME/bin

SONAR_RUNNER_HOME=$HOME/sonar-runner

退出

export PATH SONAR_HOME

使环境变量生效

Source $HOME/.bash_profile

2、 sonar-runner的配置

修改sonar.host.url、sonar.jdbc.url、sonar.jdbc.username、sonar.jdbc.password、sonar的登录名和密码，修改成实际的sonar配置

至此，sonar-runner安装完成

五、 Jenkins安装

1、 Jenkins部署

jenkins.war文件，直接放置在Tomcat的webapps目录下，启动Tomcat服务；

修改tomcat下的配置文件server.xml

2、 访问Jenkins

访问：http://127.0.0.1:8010/jenkins

可以查看到以下界面，jenkins部署完成

3、 遇到的问题及解决办法

（1）tomcat部署Jenkins时不能解压Jenkins文件，是因为tomcat里的server.xml配置文件中多了【xmlValidation="false" xmlNamespaceAware="false】这两个配置项，删除之后重新启动tomcat可以解决问题

（2）tomcat启动是，部署Jenkins时报错【SEVERE: Failed to initialize Jenkins hudson.util.AWTProblem: java.lang.InternalError: Can't connect to X11 window server using 'localhost:10.0' as the value of the DISPLAY variable.】

解决办法：原因：因为用到了图形处理，java程序会去寻找linux上的图形界面是否启动

解决：不让java寻找linux图形界面即可，在java 启动时加选项java -Djava.awt.headless=true

实现：如果是tomcat，在/tomcat/bin/catalina.sh中修改为

JAVA_OPTS=-Djava.awt.headless=true

六、 Soanr与Jenkins集成

1、安装sonar jenkins plugin 插件

在Jenkins的插件管理中选择sonar jenkins plugin ，该插件可以使每次构建时都调用sonar进行代码度量

进入配置页面对sonar插件进行配置，如下图：