开发人员写代码过程中就实现自动代码检视,编辑器会提示编码规范错误,并给出正确实例,写完代码只需要提交到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配置文件。