关于Java开发过程中质量提升-2自动化

　　开发人员写代码过程中就实现自动代码检视，编辑器会提示编码规范错误，并给出正确实例，写完代码只需要提交到SVN库，然后启动自动化构建（可配置代码提交SVN后自动触发），测试环境中的项目马上和当前SVN库一致。告别专门召集代码检视会议（或只需要检视业务流程）、告别手工编译打包、安装。

----------------------------------------------------------------------------------从word文件copy出来，懒得弄图片了，so 无图。

第一章Jenkins配置

jenkins是一个广泛用于持续构建的可视化web工具，持续构建说得更直白点，就是各种项目的"自动化"编译、打包、分发部署。jenkins可以很好的支持各种语言（比如：java, c#, php, python等几乎所有语言）的项目构建，也完全兼容ant、maven、gradle等多种第三方构建工具，同时跟svn、git能无缝集成，也支持直接与知名源代码托管网站，比如github、bitbucket直接集成。

jenkins本身是用java语言开发的，所以安装jenkins的机器至少要有jdk，另外建议git/svn、ant/maven/gradle等工具也一并安装好，方便与这些构建工具集成。

1.1 安装Jenkins

可以直接在jenkins官方网站上：https://jenkins.io/index.html

下载jenkins的文件jenkins.war文件

有两种启动方法。

首先保证系统中已经安装了jdk，最好是jdk1.8, 并配置好环境变量。

第一种启动方法，切换到jenkins.war存放的目录，输入如下命令：

$ java -jar jenkins.war

然后在浏览器中输入http://localhost:8080，localhost可以是本机的ip，也可以是计算机名。就可以打开jenkins

第二种方法是用jetty打开

将jenkins.war文件放入jetty下的webapps目录下，启动jenkins时，在地址栏上输入

http://localhost:8080/jenkins 就可以访问

1.2 配置Jenkins

由于Jenkins配置在网上资料很多，这里只列出关键操作：

1、  登录Jenkins，选择“系统管理->插件管理->可选插件”，安装如下插件；

a)         邮件插件：Email Extension Plugin

b)        Maven插件：Maven Integration plugin

c)         SVN插件：SVN Publisher plugin

d)        SSH插件：SSH plugin/Publish Over SSH

刚安装需要等一会儿才有插件列表，如果安装失败就看下失败原因，一般是因为有依赖插件未安装（在插件管理中选择的都会自动把依赖插件一起安装好），只需安装提示插件即可，有时候也会因为网络原因需要安装多次才能装上。

2、  完成插件安装后，选择“系统管理->系统设置”，配置邮件和相关服务器信息即可

　 Remote Directory是指定SSH进入的目录，注意先确认用户是否有权限。

3、  完成系统配置后，选择“系统管理-> Global Tool Configuration”，配置JDK和Maven

　　JDK和Maven需要预先安装好，然后再这里指定安装目录。

1.3 创建Job

1、创建项目

a)登录Jenkins，选择“新建”，输入项目名称后选择“创建一个*风格的软件项目”

b)进入上面建的Job，选择“配置”，进入配置界面

c)配置“丢弃旧的构建”

　　这里主要是配置构建任务的保留数

d)配置“源码管理”和“构建触发器”

　　如果公司的SVN库被加密，所以这里选择“None”，后面步骤中采用将代码下载到“/home/XXX/.jenkins/workspace/Job名称”目录中。

　　选择“Build periodically”可以定时启动构建任务，比如每天凌晨1点启动构建，另外“Poll SCM”是定时检查源码库提交情况来启动构建，由于这里没有使用源码管理，所以该选项用不上。如果有源码管理，该配置会根据指定频率检测代码变化，触发构建。

e)配置“构建环境”

　　i.如果公司SVN被加密，SVN插件不能用，所以在构建前先到服务器下载代码，选择“Send files or execute commands over SSH before the build starts”指定构建服务器，调用下载代码的脚本sh buildSVN.sh jobID svnURL例如：“sh /home/XXX/jenkins/build/buildSVN.sh JOBID SVNURL”。

　　ii. 接上面完成代码下载后，可以选择“Add Transfer Set”再加一个，到安装服务器上执行安装前数据清理操作。

iii. 完成前置操作之后，就可以配置打完包之后的操作了，选择“Send files or execute commands over SSH after the build runs”是在打完包之后进行的操作，由于项目的发布/转测试模式是打完包后，直接发邮件通知配置管理员到打包目录获取软件包，然后配置管理员根据软件包中的SVN版本号进行打分支，所以这需要做软包添加SVN版本号的处理

　iv.完成软件包处理之后，就可以将软件包上传到安装服务器上进行安装了，这里支持集群安装，有多少个集群只需要选择添加多个“Add Transfer Set”就行了

自动安装得先有自动安装脚本，这里也就是解压、调用setup.sh脚本

f)最后就是配置“构建”和“构建后的操作”

配置maven编译、打包工具, 邮件根据实际情况配置即可，其他不需要编译的非Java项目，可以不需要配“构建”选项

构建后操作，选择邮件组件，然后加上需要发送和抄送人

2、  完成配置后，直接选择“保存”，然后选择“立即构建”

a)         选择自动创建的构建任务，可以查看任务执行情况

b)        进入“Console Output”查看实时构建信息

至此，整个Jenkins操作完成！

1.4 注意事项

1、  只搭一套环境，大家都统一使用这一套即可，不要再重复维护其他的环境，直接在该环节创建Job即可，方便统一管理。

2、  启动后所有文件都存贮在 /home/用户名/.jenkins 目录下，可以通过备份/.jenkins/job/项目名/config.xml文件来保留配置。

3、  请不要随意修改其他人的Job，创建自己的就好。

第二章SonarQube配置

Sonar是一个用于代码质量管理的开源平台，用于管理源代码的质量，可以从七个维度检测代码质量，通过插件形式，可以支持包括java, C#, C/C++, PL/SQL, Cobol, JavaScrip, Groovy，Python等等二十几种编程语言的代码质量管理与检测。

2.1安装SonarQube预置条件

1、  已安装Java环境

2、  已安装有数据库（支持多种数据库，我们这里用公司统一的PostgreSQL）

3、  软件下载地址：http://www.sonarqube.org/downloads/

4、  下载SonarQube与SonarQube Runner

5、  数据库配置:

进入数据库命令
su postgres
psql
create user sonar with password 'sonar'; 
create database sonar owner sonar;
grant all privileges on database sonar to sonar;

2.2安装SonarQube和 sonar-runner

安装sonar与sonar-runner

a)  
将下载的sonar-3.7.zip包解压至Linux某路径如/usr/local

b)  
将下载的sonar-runner-dist-2.3.zip包解压某路径/usr/local

c)  
添加SONAR_HOME、SONAR_RUNNER_HOME环境变量，并将SONAR_RUNNER_HOME加入PATH

d)  
修改sonar配置文件

修改/conf/sonar.properties文件，配置数据库设置，默认已经提供了各类数据库的支持
这里使用PostgreSQL，因此取消PostgreSQL模块的注释,然后

e)    
修改sonar-runner的配置文件

修改/conf/sonar-scanner.properties文件

2.3配置SonarQube

1、 执行安装目标下/bin/linux-x86-64/sonar.sh
start|stop|restart 就可以进行启停重启操作。

2、 启动服务后访问http:\\localhost:9000即可

3、 登录SonarQube服务器后，可以查看项目中的问题、指标，并可以对代码规则、质量配置、质量阀和系统进行设置

4、
其中质量配置和质量阀都可以每个项目创建自己的标准，然后在项目指定即可

5、 如果有些指标项目需要调整，可以直接在问题中对相关指标进行修改

6、 修改完指标和阀值后重新运行sonar-runner就会根据最新规则进行分析

2.4配置sonar-runner

1、
在项目源码的根目录下创建sonar-project.properties配置文件，文件内容如下

sonar.projectKey=项目名

sonar.projectName=Simple Android project analyzed with the SonarQube Runner

sonar.projectVersion=1.0

sonar.sources=src

sonar.binaries=bin/classes

sonar.language=java

sonar.sourceEncoding=UTF-8

这里language可以是C/C++/Python等其他语言

2、
因为环境变量已配置，可在任意目录下执行sonar-runner命令，运行完成后登录到SonaQube，就可以查看刚刚添加的项目分析情况了

2.5Eclipse配置SonarLint插件（Java）

1、
打开eclipse，进入help->Eclipse Marketplace，输入sonar，安装sonarLint

2、
完成安装重启eclipse后，在window->show view中选择Sonar三个视图

3、
在SonarQube
Service中配置SonarQube服务信息

4、
最后右击项目工程，选择SonarLint->build…
然后选择对应的项目（可以在Sonar服务上配置好项目，供这里选择，也可以不配置）

5、
最后打开类文件就可以看到实时的分析结果了

该操作只用于eclipse，其他项目可以使用sonar-runner分析后登录SonarQube服务器上查看分析结果。

2.6注意事项

1、  只搭一套环境，大家都统一使用这一套即可，不要再重复维护其他的环境，直接在该环节创建Job即可，方便统一管理。

2、  每个项目可以到SonarQube服务器定制自己的编码规范，都创建自己项目的，其他项目的不要动。

3、  Jenkins自动化过程中，调用SVN代码下载之后会调用自动代码分析，需要注意在代码根目录添加sonar-project.properties配置文件。