Jenkins-持续集成环境搭建.doc

持续集成环境搭建一、 简介持续集成是一种软件开发实践，即团队开发成员经常集成它们的工作，通过每个成员每天至少集成一次，也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建（包括编译，发布，自动化测试）来验证，从而尽早地发现集成错误，持续集成是个简单重复劳动，人来操作费时费力，使用自动化构建工具完成是最好不过的了,本文档采用的是Jenkins+Selenium+Sonar搭建持续集成环境，完成版本持续集成，自动化测试及代码检测分析的功能。二、 Jenkins部署1. Jenkins下载与安装在最简单的情况下，Jenkins只需要两个步骤：（1） 直接运行iar包下载最新的版本（一个WAR文件）,Jenkins官方网址:http:/Jenkins-ci.org/运行java-jarjenkins.war注意：Jenkins需要运行Java5以及以上的版本（2） 将下载的war包文件部署到web容器例如将jenkins.war部署到tomcat的webapps目录下,然后启动tomcat，在浏览器的URL地址栏中输入类似http:/localhost:8080/jenkins/这样的地址即可。将jenkins.war部署到tomcat的webapps目录下windows启动：切换到tomcat的bin目录，启动startup.bat。Linux启动：切换到tomcat的bin目录，运行./catalina.sh start启动，运行./catalina.sh stop关闭。2. 修改Jenkins启动内存打开startup.sh文件，在最上面加上export JAVA_OPTS=-XX:MaxPermSize=1024m -Xms1024m -Xmx3096m。3. 访问访问地址为http:/ip:8080/jenkins，已在阿里云上部署，地址为：http:/www.allianity.com:8180/jenkins/。4. 插件安装（在系统管理-插件管理，可选择中搜索）1) 安装Sonar插件，搜索SonarQube Plugin插件(代码质量分析)，并勾选，点击直接安装即可。2) 安装war部署容器插件，搜索Deploy to container Plugin插件，该插件支持部署到tomcat和jboss里面。3) 安装Email插件，搜索Email Extension Plugin和Email Extension Template Plugin，支持邮件发送和邮件自定义内容。5. 系统设置（在系统管理模块）（1） 提示信息1) Utf-8编码Jenkins建议在tomcat中使用utf-8编码，配置tomcat下conf目录的server.xml文件2) 新的版本有需要的话点击下载新的版本即可3) 安全设置允许网络上的任何人代表您启动进程。考虑至少启用身份验证来阻止滥用。点击Dismiss忽略该消息,点击SetupSecurity进入设置界面（2） 系统设置1) JDK配置JDK别名：给你看的，随便你自己，叫阿猫阿狗都可以JAVA_HOME：这个是本机JDK的安装路径（错误的路径会有红字提示你的）自动安装：不推荐这个选项后面Ant与Maven的配置是一样的，JDK去oracle官网下载，Ant与Maven去apache官网下载Ps：每个文本框后面都有个问号，点击问号就会出现帮助信息2) Maven配置MAVEN_HOME是你本机的maven安装路径maven项目配置里需要填上你需要访问的jenkins的地址和系统管理员邮箱的地址3) Ant配置4) 邮件通知配置Ps:这里系统管理员的邮件地址一定要配置,不然发邮件的时候会报错5) SonarQube配置这里配置是的当构建好项目时会将构建好的项目发送到配置好的sonar服务器去进行代码质量检测,需要填写的是sonar服务器的地址,数据库地址还有用户名和密码三、 Sonar部署1. Sonarqube简介Sonar是一个用于代码质量管理的开源平台，用于管理源代码的质量，可以从七个维度检测代码质量通过插件形式，可以支持包括java,C#,C/C+,PL/SQL,Cobol,JavaScrip,Groovy等等二十几种编程语言的代码质量管理与检测Sonarqube能带来什么?1).糟糕的复杂度分布文件、类、方法等，如果复杂度过高将难以改变，这会使得开发人员难以理解它们，且如果没有自动化的单元测试，对于程序中的任何组件的改变都将可能导致需要全面的回归测试2).重复显然程序中包含大量复制粘贴的代码是质量低下的, sonar可以展示源码中重复严重的地方3).缺乏单元测试sonar可以很方便地统计并展示单元测试覆盖率4).没有代码标准sonar可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具规范代码编写5).没有足够的或者过多的注释没有注释将使代码可读性变差，特别是当不可避免地出现人员变动时，程序的可读性将大幅下降, 而过多的注释又会使得开发人员将精力过多地花费在阅读注释上，亦违背初衷6).潜在的bugsonar可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具检测出潜在的bug7).糟糕的设计通过sonar可以找出循环，展示包与包、类与类之间的相互依赖关系, 可以检测自定义的架构规则, 通过sonar可以管理第三方的jar包, 可以利用LCOM4检测单个任务规则的应用情况检测耦合2. 下载从Sonar官网下载SonarQube包，地址http:/www.sonarqube.org/downloads/，目前最新版本是SonarQube 5.1.2。从http:/docs.sonarqube.org/display/PLUG/Plugin+Library下载汉化包。3. 安装部署Sonar1) 预置条件已安装JAVA环境;已安装有MySQL数据库2) 解压sonarqube-5.1.2.zip3) 修改配置文件打开sonarqube-5.1.2confsonar.properties打开连接数据库的用户名和密码打开数据库的地址和驱动4) 创建数据库在mysql数据库中新建名称为sonar的数据库，并新建一个用户，sonar/sonar，然后将sonar数据库的所有权限赋给sonar用户5) 汉化插件将汉化包sonar-l10n-zh-plugin-1.9.jar放到sonarqube-5.1.2extensionsplugins目录下。4. 启动Sonar（1） 、windows启动，直接进入sonarqube-5.1.2binwindows-x86-32|64目录，运行StartSonar.bat，这样sonar就可以启动成功了，注意事项：sonarqube-5.1.2在Windows放置的路径不要包含中文字符，否则启动有问题，且5.1.2版本只支持JDK1.7及以上的版本。（2） 、linux启动，进入sonarqube-5.1.2binlinux-x86-32|64目录，运行./sonar.sh start可以启动，运行./sonar.sh stop可以停止。注意事项：在运行前，linux环境java变量必须是1.7以上，且需要先执行chmod u+x *.sh，chmod u+x wrapper.conf5. 访问Sonar访问地址为http:/ip:9000即可访问，默认端口是9000，已在阿里云上面部署过Sonar，地址为http:/www.allianity.com:9000/。备注：本地已配置好，见当前目录中的 持续集成相关发布包sonar.zip，解压之后即可正常使用。四、 项目构建（jenkins+maven+svn+sonar）在jenkins上你可以配置maven项目也可以配置任意的项目1) 填写项目名称2) 配置源代码管理在这里可以配置svn或者cvs等等源码管理,配置好地址之后jenkins就会从相应的源码路径拷贝出项目并进行编译构建的过程演示是使用Subversion的链接，在RepositoryURL中输入你的项目链接，如果没有权限则会提示如下图,可以去配置svn用户名和密码3) 配置构建触发器（表示5分钟扫描一次，如SVN有更新，则重新构建）在其他项目构建完成后才执行构建：指定的项目完成构建后，触发此项目的构建。PollSCM：这是CI系统中常见的选项。当您选择此选项，您可以指定一个定时作业表达式来定义Jenkins每隔多久检查一下您源代码仓库的变化。如果发现变化，就执行一次构建。例如，表达式中填写0,15,30,45*将使Jenkins每隔15分钟就检查一次您源码仓库的变化。Buildperiodically：此选项仅仅通知Jenkins按指定的频率对项目进行构建，而不管SCM是否有变化。如果想在这个Job中运行一些测试用例的话，它就很有帮助。4) 配置Maven构建文件及命令(maven项目才需要配置)5) 配置失败邮件配置6) 配置构建后SonarQube代码分析在这里配置就是将你构建好的项目发送到sonarqube服务器上7) 远程部署配置，其中WAR/EAR files为要部署的war包，Context path为部署到tomcat容器中的war的名称，即部署的war为jenkinstest.war，Manager user name和Manager password为tomcat-user.xml中配置的用户，tomcat url为tomcat访问地址。8) 配置构建后邮件发送功能（成功或失败时的邮件接收人），多个接收人用,号隔开。五、 Jekins与Selenium结合可以选择安装火狐插件,在启动插件后录制网页六、 Jenkins和Ant的结合1. Ant简介首先Apache Ant,是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具,我们从最基础的例子说起,我们用一个记事本编写一个最简单的java文件,然后在命令行中可以通过javac这个命令将.java的文件编译成.class的文件,其实使用ant所做的操作和使用命令行的操作是一样的,只不过它将各种命令转化为xml标签,所有使用ant的时候必须有以下两点:一个是使用ant 编译工程，必须有一个xml文件，默认build.xml,第二个就是每个build文件配置一个default target，执行ant命令会执行这个target,在build.xml中允许存在多个target标签, 每个target是一个操作，clean是删除build目录，compile是编译，run是执行java class,所以当使用ant编译工程时可以根据需求编写build.xml;(还可以使用eclipse生成build.xml,步骤是右键. Export- General - Ant Buildfiles .点Next,选择项目，再点Finish.)2. 创建项目在eclipse中创建一个简单的测试ant的项目,并编写好build.xml文件放在项目根目录下,并将项目提交到svn中3. Jenkins构建首先创建一个自由风格的项目,在项目配置中有两种构建方法,前提是我们已经下载好antI、选择Execute Windows batch command，在输入框输入如下命令set path=C:ANT_HOMEApache-Ant-1.7.0bin;path把ant的安装目录添加到pathant junit 执行junit taskII、方法I比较麻烦，如果我们设置好了ANT_HOME,可以选择Invoke Ant，然后在targets里面指定我们build.xml里的task name。不填的话默认根目录下的build,xml文件然后点击立即构建即可4. ant与selenium结合在使用ant构建项目时,我们可以通过build.xml中的配置来与其他测试工具整合,去加载selenium的jar即可