jenkins中文使用手册范本.docx
Jenkins操作手册苏州测试部第1章概述1第2章基础篇32.1 Jenkins安装32.1.1 资源下载32.1.2 运行JenkillS的前提32.1 .3Jenkins启动32.2 .4Jenkins访问42.2 Jenkins基本设置82.2.1 设置JDK92.2.2 设置ANT92.2.3 配置邮件信息102.3 创建任务102.4 运行并监控构建作业152.4.1 主控制面板152.4.2 手动构建一个任务152.4.3 任务构建状态16第3章提高篇：183.1 插件管理：183.1.1 FindBugs插件设置183.1. 2Ftp插件配置203.1.3 Junit插件213.1.4 通过远程访问触发213.1 .5WebLogic.Deployer213.2 安全篇223.3 个性化设置23第4章常见问题254.1 editlock问题254.2 IOException:Unabletodelete问题254.3 notrecognizedasavalidapplicationtype问题26第5章其它说明275.1 CI挑战285.2 ANT基本知识28第1章概述1.1什么是持续集成随着软件开发复杂度的不断提高，团队开发成员间如何更好地协同工作以确保软件开发的质量已经慢慢成为开发过程中不可回避的问题。尤其是近些年来，敏捷（AgiIe）在软件工程领域越来越红火，如何能再不断变化的需求中快速适应和保证软件的质量也显得尤其的重要。持续集成正是针对这一类问题的一种软件开发实践，对于提高软件开发效率并保障软件开发质量提供了理论基础。它倡导团队开发成员必须经常集成他们的工作，甚至每天都可能发生多次集成。而每次的集成都是通过自动化的构建来验证，包括自动编译、发布和测试，从而尽快地发现集成错误，让团队能够更快的开发内聚的软件。持续集成最早由MartinFowler于10年前已经提出，希望通过持续集成能够实现以下过程：任何人在任何地点，任何时间可以构建整个项目。在持续集成构建过程中，每一个单元测试都必须被执行。在持续集成构建过程中，每一个单元测试都必须通过。持续集成构建的结果是可以发布的软件包。当以上任何一点不能满足时，整个团队的主要任务就是去解决这个问题。1.2持续集成的核心价值持续集成中的任何一个环节都是自动完成的，无需太多的人工干预，有利于减少重复过程以节省时间、费用和工作量；持续集成保障了每个时间点上团队成员提交的代码是能成功集成的。换言之，任何时间点都能第一时间发现软件的集成问题，使任意时间发布可部署的软件成为了可能；持续集成还能利于软件本身的发展趋势，这点在需求不明确或是频繁性变更的情景中尤其重要，持续集成的质量能帮助团队进行有效决策，同时建立团队对开发产品的信心。1.3持续集成的原则业界普遍认同的持续集成的原则包括：1）需要版本控制软件保障团队成员提交的代码不会导致集成失败。常用的版本控制软件有IBMRationaIClearCaseCVS、Subversion等；2）开发人员必须及时向版本控制库中提交代码，也必须经常性地从版本控制库中更新代码到本地；3）需要有专门的集成服务器来执行集成构建。根据项目的具体实际，集成构建可以被软件的修改来直接触发，也可以定时启动，如每半个小时构建一次；4）必须保证构建的成功。如果构建失败，修复构建过程中的错误是优先级最高的工作。一旦修复，需要手动启动一次构建。1.4持续集成系统的组成由此可见，一个完整的构建系统必须包括：> 一个自动构建过程，包括自动编译、分发、部署和测试等。> 一个代码存储库，即需要版本控制软件来保障代码的可维护性，同时作为构建过程的素材库。> 一个持续集成服务器，本文中介绍的JenkinS/Jenkins就是一个配置简单和使用方便的持续集成服务器。1. 5Jenkins介绍JenkinS是一个软件界非常流行的开源CI服务器，HOdSon是基于JaVa开发的一种持续集成工具，用于监控持续重复的工作，功能包括：> 持续的软件版本发布/测试项目。> 监控外部调用执行的工作。Jenkins的新版本取名叫Jenkins,所以本文档中的指JenkinS与JenkinS这2个词为指同一个软件。使用JenkirlS人员需要对持续集成的概念有所了解，更多的要求对代码的编译过程很了解，Jenkins对于maven工程完整的编译和发布流程如下：> Jenkins从SVN上拉取代码到指定的编译机器上。> 在编译机器上触发编译命令或脚本。编译得到的结果文件。> 把结果文件传到指定的服务器上。使用JenkinS进行编译的人员，需要对自己的代码的编译方法，过程十分了解，对编译任务进行分拆。第2章基础篇2.1 Jenkins安装1.1 .1资源下载首先从http:jenkins-ci.org/下载最新的jenkins版本，最新版本为1.594,下载的文件载体为jenkins.war；Jenkins为免费开源软件，并且更新速度稳定，每周一次更新。所以网站上会提供有2个版本，一个最新版本，一个老但稳定的版本。可自行选择。1.2 .2运行Jenkins的前提D环境变量的设置：a) JAVA_H0ME,设置JDK的安装目录，建议采用JDKL7,但不建议用JDKL8b) ANT_H0ME,设置Am的目录，验证过ant最新版本1.9.4可用。c) JENKINS_HOME,设置JenkinS的配置文件目录，默认为用户的目录，建议为JenkinS的安装目录，便于控制；d) MEVAN_HOME,设置MaVen的目录，验证3.2.3可用。e) PATH,需要将java、ant,maven的bin目录配置到Path目录下;f) CLASSPATH,需要将JDK的tools.jar配置到classpath目录中；2. 1.3Jenkins启动可以有两种方法进行运行jenkins；a)直接通过命令行如下：optjdkl.7.0-71binjava-jaroptjenkins.war-httpPort=8089-logfile=optjenkinsjenkins.log说明：httpPort为jenkins运行的端口，默认端口为8080,上述命令其实让Jenkins运行在Winstone容器中；以下有一些常用的参数：更多参数可以查看http:/WinStone.sourceforCommandLineParameterDescription-httpPort=$HTTP_PORTRunsJenkinslisteneronport$HTTP_PORTusingstandardhttpprotocol.Thedefaultisport8080.Todisable(becauseyou'reusinghttps),useport-1.-httpListenAddress=$HTTP_HOSTBindsJenkinstotheIPaddressrepresentedby$HTTP_HOST.Thedefaultis0.0.0.0i.e.listeningonallavailableinterfaces.Forexample,toonlylistenforrequestsfromlocalhost,youcoulduse:-httpListenAddress=127.0.0.1-httpsPort=$HTTP_PORTUsesHTTPSprotolonport$HTTP_PORT-httpsListenAddress=$HTTPS_HOSTBindsJenkinstolistenforHTTPSrequestsontheIPaddressrepresentedby$HTTPS_HOST.-Prefix=SPREFIXRunsJenkinstoincludethe$PREFIXattheendoftheURLForexample,tomakeJenkinsaccessibleathttp:/nyServer:8080/jenkins,set-prefi×=jenkins-ajp13Port=$AJP_PORTRunsJenkinslisteneronport$AJP_PORTusingstandardAJP13protol.Thedefaultisport8009.Todisable(becauseyou'reusinghttps),useport-1.-ajp13ListenAddress=$AJP_HOSTBindsJenkinstotheIPaddressrepresentedby$AJP_HOST.Thedefaultis0.0.0.0i.e.listeningonallavailableinterfaces.-argumentsRealm.passwd.$ADMIN_USERSetsthepasswordforuser$ADMIN_USER.IfJenkinssecurityisturnedon,youmustloginasthe$ADMIN_USERinordertoconfigureJenkinsoraJenkinsproject.NOTE:Youmustalsospecifythatthisuserhasanadminrole.(Seenextargumentbelow).-argumentsRealm.roles.$ADMIN_USER=adminSetsthat$ADMIN_USERisanadministrativeuserandcanconfigureJenkinsifJenkins'securityisturnedon.SeeSeCUrinaJenkinSformoreinformation.-Xdebug-Xrunjdwp:transport=dt_socket,address=$DEBUG_PORT,server=y,suspend=nSetsdebuggingonandyoucanaccessdebugon$DEBUG_PORT.-IOgfiLOG_PATH/winsk)ne_'date+,%Y%m-%d-%H-%M",.logLoggingtodesiredfile-XX:PermSiZe=512M-XXrMa×PermSize=2048M-Xmn128M-Xms1024M-Xmx2048MreferringtotheseODtiOnSforOraCleJaVab）在Web容器中运行JenkinS可以运行在标准的Web服务器中，支持TOmCat、JbOSs、WebLOgiC中，只需要将JenkinS.war放置到相应目录，启动服务就可以进行访问；推荐采用这个方式运行，方便配置和迁移。2.1. 4Jenkins访问验证jenkins是否运行正常，通过访问http:10.1.200.59:8089即可。Hudosn应用支持IE、FireFox等;浏览器。2.1. 5分布式jenkins安装为了满足各种编译环境的需求，jenkins支持分布式，以jenkinsagent的形式运行SlaVe机。1 .在jenkins的主机上，选择系统管理>管理节点2 .新节点>输入名字3. 选择DumbS
