jenkins安装与配置文档

入门手册 目录 第一章 是什么? 的由来 的目标 第二章 安装与配置 安装 配置 3.1系统管理 提示信息 系统设置 安全设置 管理用户设置 管理插件设置 3.2项目构建设置 构建自由风格的 构建 风格的 邮件通知设置 文件部署设置 3.3监控 4 插件 插件安装 插件安装示例 入门手册 第一章 Jenkins是什么? Jenkins是一个可扩展的持续集成引擎。 主要用于: ●持续、自动地构建/测试软件项目。 监控一些定时执行的任务。 Jenkins拥有的特性包括 易」安装-只要把 jenkins.war部署到 servlet容器,不需要数据库支持。 易于配置-所有配置都是通过其提供的web界面实现 ●集成RSS)-maii通过RsS发布构建结果或当构健完成吋通过e-mail通知。 ●生成 JUnit/ TestNG测试报告 分布式构建支持 Jenkins能够让多台计算机一起构建/测试。 文件识别: Jenkins能够跟踪哪次构建生成哪些jar,哪次构建使用哪个版木的jar等。 ●插件支持:支持扩展插件,你可以开发适合自己闭队使用的工具。 1 Jenkins的由来 日前持续集成(CI)己成为当前许多软件开发团队在整个软件开发生命周期内侧重于保 证代码质量的常见做法。它是一种实践,旨在缓和和稳固软件的构建过程。并且能够帮助您 的开发团队应对如下挑战 ●软件构建自动化:置完成后,CI系统会依照预先制定的时间表,或 者针对某一特定事件,对目标软件进行构建, 构建可持续的自动化检査:CI系统能持续地获取新增或修改后签入的 源代码,也航是说,当软件开发团队需要周期性的检査新増或修改后的 代码时,CI系统会不断确认这些新代码是否破坏了原有软件的成功构 建。这减少了开发者们在检查彼此相互依存的代码中变化情况需要花费 的时间和精力(说直接一点也是钱啊,呵呵)。 ●构建可持续的自动化测试:构建检查的扩展部分,构建后执行预先制定 的一套测试规则,完成后触发通知( Email,RSS等等)给相关的当事人 生成后后续过程的自动化:当自动化检查和测试成功完成,软件构建的 周期中可能也需要一些额外的仼务,诸如生成文档、打包软件、部署构 件到一个运行环境或者软件仓库。这样,构件才能更迅速地提供给用户 使用。 部署一个CI系统需要的最低要求是,一个可获取的源代码的仓库,一个包 含构建脚本的项目。 下图概括了系统的基本结构 第页 入门手册 rrect Deliverable ymen: T Cofiguration Pect Source Control Revision= a Work Sauce est Package CM Artifacts FRish cators Continuous Integration Server Source code Server Console Ratrisre Deliverables Request Builds 图1系统的基本结构 该系统的各个组成部分是按如下顺序来发挥作用的: 开发者检入代码到源代码仓库。 系统会为每一个项目创建了一个单独的工作区。当预设或请求一次新的构建时 它将把源代码仓库的源码存放到对应的工作区。 系统会在对应的工作区内执行构建过程 配置如果存在)构建完成后,系统会在一个新的枃件中执行定义的一套测试。 完成后触发通知(Emai1l,RSS等等)给相关的当事人。 (配置如果存在)如果构建成功,这个枃件会被打包并转栘到一个部署目标如应用 服务器或存储为软件仓库中的一个新版本。软件仓库可以是系统的一部分,也 可以是一个外部的仓库,诸如一个文件服务器或者像 之类的 网站。 系统通常会根据请求发起相应的操作,诸如即时构建、生成报告,或者检索一些 构建好的构件 就是这么一个系统。之前叫做 以下是使用 的·些理由: 是所有CI产品中在安装和配置上最简单的 基于Web访问,用户界面非常友好、直观和灵活,在许多情况下,还提供了AJAX 的即时反馈 ● Jenkins是基于Java开发的(如果你是一个Java开发人员,这是非常有用的),但 它不仅限于构建基于Java的软件。 Jenkins拥有大量的插件。这些插件极大的展了 Jenkins的功能;它们都是开源 的,而且它们可以直接通过veb界面来进行安装与管理。 1.1 Jenkins的目标 的主要目标是监控软件开发流程,快速显示问题。所以能保证开发人员以及相 第页 入门」手册 关人员省时省力提高开发效率 系统在整个廾发过程中的主要作用是控制:当系统在代码存储库中探测到修改时, 它将运行构建的仟务委托给构建过稈本身。如果构建失败了,那么系统将通知相关人员, 然后继续监视存储斥。它的角色看起来是被动的;但它确能快速反映问题。 特别是它具有以下优点: ● Jenkins一切配置都可以在web界面上完成。有些配貿如 MAVEN HOME和 Email,只需要 配置一次,所有的项目就都能用。当然也可以通过修改XIML进行配置。 ●支持 Maven的模块( Module), Jenkins对 Maven做了伉化,因此它能自动识别 Module, 每个 Module可以配置成个job。相当灵活。 测试报告聚合,所有模块的测试报告都被聚合在一起,结果一目了然,使用其他CI, 这儿乎是件不可能完成的任务。 ●构件指纹( artifact fingerprint),每次 build的结果构件都被很好的自动管理,无需 任何配置就可以方便的浏览下载。 第二章 Jenkins安装与配置 2 Jenkins安装 在最简单的情况下, 只需要两个步骤 下载最新的版本(一个 文件) 官方网址 运仃Java- Jar Jenkins.war 注意: 需要运行 以及以上的版本 还有一种安装方式就是将下载的包文件部署到 容器,然后启动容器,在浏 览器的地址栏中输入类似 这样的地址即可。下图是安装成 功后的界面(使用的是 环境): Je elkins 搜索 Jenkins A ENABLE AUTO REFRESH 新』Qb 次辽使用] elkins!请点击新建仟经开始使月. 查看用户 系统理 任努队列 当前队列有构足任多 任务状志 状志 2罕闹 图2 主界面 第页 入门手册 3 Jenkins配置 写在配置前的一些话: 的配置不可能仝部都说到的,大部分配置是有英文说明的, 点击输入框后面的问号就可以看见了。英文不会用翻译工具,连蒙带猜的,多测试几次,你 就懂了 31系统管理 在已运行的 主页中,点击左侧的系统管理进入如下界面: 系统管理 Your container doesnt use UTF-8 to decode URL5. If you use non-ASCII characters as a job name etc this will cause problems. See Containers and Tomcat i18n for more details A New version ul Jenkins(1.518ENKCINS-14362-jzlib)is dvdildble for uuwnludd ( chdngeluy) Unsecured Jenkins allows amyone on the network to launch processes on your behalf. Acuity demise Setup se curity Consider at least enabling authentication to discourage misuse 系场设置 全局设置&径 Configure Global Security Secure Jenkins; celine who is allowed to access/use the system 读取没 放弃当前内存中有物置信息并从罡文件口重取少书于当您手动修文件时重读取设置 添加、刑除、禁用求户用] elkins功能打展插仁。 updates available 只自曰 系综言息 显示系统环境信息以郫助解决问题。 System ng 杀统三志从jV,ui1.1gin捕家] cntrs目天的日志信息。 负戴统让 位查您的游利用情兄。看看是平需要更多的计算机来却則构建 elkins CI T 您命令行或脚本访j管理您 coking& 脚本金空红 执行用于管理或故障探则或诊断的意本台令。 图3 系统管理 提示信息 版本不同提示的消息有可能不同 3.1.1.1Utf-8编码 Your container doesn't use UTF-8 to decode URLS. If you use non-ASCII characters as a job name etc, this will cause problems. See Containers and Tomcat i18n for more details 建议在 中使用编码,配置下目录的 文件 第页 入门手册 图4 编码设置 如果的控制台中文输出乱码,请将 ””更改为 31.1.2新的版本 New version of Jenkins(1.518.JENKINS-14362-jzlib) is available for download (changelog) 提示有新的版本可以下载了,喜欢更新的点击 download去下载吧! 3.1.1.3安全设置 Unsecured Jenkins allows anyone on the network to launch processes on your behalf. Setup security Consider at least enabling authentication to discourage misuse 图5安全提示消息 詹金斯允许网络上的任何人代表您启动进程。考虑至少启用身份验证米阻止滥用。点击 忽略该消息点击 进入设置界面详细设置请参考 安全设置章节 系统设置 在已运行的 主页中,点击左侧的系统管理一系统设置进入如下界面: 主目录 /root/.jenkins 系统消息 [ RaW hTMl]预览 执行者数里 生成前等待时间 SCM签出重试次数 Restrict project naming 图6系统设置界面 第页 入门手册 3.1.2.1JDK、 Maven、Ant配置 配冒一个 实例,请在每一节下面单击新增按钮,这里将添加实例 的名称和绝对地址。下图描述了这两个部分。 JDK JK专装 S: JDK 名 jdk1.5.73 JAVA-HOME srjavaijdk1.6.0_23) 口自装 州JDK 折增JK 系統下JDK安笔 图7配置界面 别名:给你看的,随便你自己,叫阿貓阿狗都可以 这个是本机的安装路径(错误的路径会有红字提示你的) 自动安装:不推荐这个选项 后面Ant与 Maven的配置是一样的,DK去 oracle官网下载,Ant与 Maven去 apache官网下载 Ps:每个文本框后面都有个问号,点击问号就会出现帮助信息 31.2.2邮件通知配置 配置发件人地址 Jen kins location jenkins url tp://192 v6/jenkins/ System Admin e-mail address jsbjenkin■ Lch 图8发件人地址配置界面 System Admin e- mail address: Jen kins邮什发送地址,如果你这个没有配置,等着发邮件的时候报 错吧,当时我也是这儿没有配置,郁闷了我一的时间。⊙_⊙b汗 第页 入门手册 配置邮件通知 isbienkins UTF-8 区遥过发送进即试在置 图9邮件通知 这个就非常的简单了,根据的的邮箱提供者的参数配置就行了。 :小技巧:用户默认邮件后缀配置了后,以后你填写邮件地址只需要之前的行了 3.1.2.3 Subversion配置 Subversion Subversion Workspace Version1.7 Exclusion revprop name a Validate repository URLs up to the first variable name v Update default Subversion credentials cache after successful authentication 图10 配置 Subversion Workspace Version: Subversion的版本号,选择你对应的版本号就行了 安全设置 在已运行的 主贞中,点击左侧的系统管理 进入如 下界面 第页