Jenkins安装部署及操作说明文档

Jenkins部署及操作手册1Jenkins工作原理

2Jenkins安装

2.1软件包/插件

2.2部署

2.2.1J DK安装

下载JDK1.8版本进行安装，安装后进行系统环境变量配置：

2.2.2A NT安装

下载绿色版apache-ant-1.9.6拷贝至安装目录下(如：

D:\tools\apache-ant-1.9.6)，配置系统环境变量：

2.2.3M aven安装

下载绿色版apache-maven-3.3.9拷贝至安装目录下(如：

D:\tools\apache-maven-3.3.9)，配置系统环境变量：

2.2.4T omcat安装

下载绿色版Tomcat8拷贝至安装目录(如：D:\tools\tomcat8-jenkins)，配置D:\tools\tomcat8-jenkins\conf\server.xml文件，添加URIEncoding="UTF-8"

2.2.5J enkins安装

下载jenins.war包，拷贝至tomat的webapps目录下(如：

D:\tools\tomcat8-jenkins\webapps\)，配置系统环境变量：

(C:\Users\Administrator\.jenkins)

●启动tomcat，启动结束后，打开IE浏览器输入:http://127.0.0.1:8080/jenkins，

提示输入密码进行下一步插件的安装，安装插件有两种方式选择，一种是按它提供的建议方式安装插件，另外一种方式是用户指定选择安装插件。插件安装过程中需要等待较长时间。

●插件安装：登录Jenkins，在系统管理页面打开插件管理，选择可选插件选项

卡，勾选需要安装的插件。

●设置用户注册：登录Jenkins，在系统管理页面打开Configure Global Security，

访问控制安全域勾选允许用户注册。

Global Tool Configuration页面配置：

1）JDK配置如下：

注：JDK此处配置两个，当Jenkins部署分布式时，要设置主节点和从节点服务器的JDK环境变量。

2）ANT配置如下：

注：Ant同理JDK，如果主从节点服务器配置的Ant是相同的系统环境变量，此处可设置如上图。

3）Maven配置如下：

注：Maven同理Ant，如果主从节点服务器配置的Maven是相同的系统环境变量，此处可设置如上图。

2.3Jenkins+ANT+SVN+Tomcat部署

新建一个项目，名字自定义，如：monitor，选择“构建一个自由风格的软件项目”，配置如下：

添加项目名称：monitor

选择SVN版本，设置下载项目的SVN访问地址及配置SVN用户名和密码，如下图：

想要什么时候开始自动构建。我这里选择Poll SCM，该方案能定时检代码版本库是否有新的提交，如果有则自动构建。我设置的日程表是“H/5 * * * *”，即5分钟自动检查一次代码版本库是否有新的提交。

当部署主从节点分布式时，才需配置如下：

这里选择的是ant进行代码的构建。Ant Version选择Default，他会默认在Jenkins仓库中的项目中build.xml文件。

将构建后的war包发布到远程的Tomcat中。Tomcat需要设置用户权限，并且远程Tomcat必须启动。

远程部署程序的tomcat还需配置tomcat-users.xml文件，如下：

context.xml文件，如下：

2.4Jenkins+Maven+SVN+Tomcat部署

新建一个项目，项目名称自己命名，如（ucap3.2）；选择构建一个maven项目。

General：设置项目名称、描述等

源码管理：设置下载项目的SVN访问地址及配置SVN用户名和密码

构建触发器

Build

在高级设置中，指定使用项目的settings.xml

构建后操作

2.5Jenkins分布式部署

Jenkins，设置系统环境变量。

54_salve(从节点)：部署在192.168.203.54上，需要部署JDK、Ant、Maven，不用再安装Jenkins，但是也要设置JDK、Ant、Maven、Jenkins系统环境变量；

主节点上面安装步骤已说明，接下来对配置从节点进行说明。

JDK系统环境变量：

Ant系统环境变量：

Maven系统环境变量：

Jenkins系统环境变量：

境变量。

登录Jenkins，在系统管理页面打开管理节点，并点击“新建节点”，如下：

远程工作目录：指定远程中的节点机器的工作目录，即Job中checkout出的代码所在的workspace目录。

标签：该节点的唯一标识，当在Job中要指定只在该节点进行构建与测试时，通过该唯一标识进行指定。

其中启动方法有四种：

Launch slave agents on Unix machines via SSH：当节点为Unix slaves时，可以选择此种方式。

Launch slave agents via Java Web Start：使用JNLP方式来建立slave与master 的连接。

Launch slave via execution of command on the Master：使用命令行方式。

Let Jenkins control this Windows slave as a Windows service ：Jenkins将把该Windows slave当做Windows service进行控制。对于Windows操作系统的节点，

推荐用第二种Launch slave agents via Java Web Start

注：启动方法：Launch slave agents via Java Web Start，是没有显示的，必须在系统管理-Configure Global Security页面配置如下，勾选随机选取。

点击“保存”后，在54_salve一个从节点就配置好了，

当节点以Launch slaveagents via Java Web Start配置好后，在节点界面将看到如图所示，其slave有三种启动方法，本质上其实就一种，即将master中的slave-agetn.jnlp文件下载至slave所在的虚拟机，然后运行文件。

注：上图中Run from slave command line中的ip地址，如果在jenkins系统配置界面中没设置过ip的话，将为localhost，因此此时需要自己先查看下自己master机器的ip。

系统配置页面，如下：

点击Launch，下载得到slave-agent.jnlp文件，将该文件拷贝至从节点服务器上安装

双击打开这个文件，显示Connected，即表示此节点创建成功。运行结果如下：

打开File菜单栏下“Install as a service”，安装把这个从节点加入windows服务。

注：在安装过程中会碰到问题：浏览器禁用java应用程序启动，解决方法如下：

打开java控制面板，在安全选项卡“启用浏览器中的Java内容”。

在返回到Jenkins的管理节点配置页面，刷新页面，出现以下情况，说明主从节点分布式部署成功，如下：

2.6邮件通知配置

需下载安装插件Mailer Plugin

登录Jenkins，打开系统配置页面，配置如下：

在job配置，如下：

3常见问题

3.1Jenkins工程配置完成，能够正常构建之后，再次打开配置页

面修改配置，构建失败。

再次配置时，tomcat密码需要重新输入。

3.2项目编译后在不同目录下生成多个war包，需要将不同的

war报发布到不同的tomcat

比如云平台，编译后生成services.war、cas.war、ccip-ucap.war，并且3个war文件要部署到不同的tomcat。

创建一个maven项目的工程ucapcloud-services，具体配置参考Maven 项目+SVN+Tomcat，并将services.war发布到203.44:8181的tomcat中。

创建一个自由风格的工程ucapcloud-ccip-ucap-cas，将ucapcloud-services 中编译打包后的cas.war、ccip-ucap.war复制到ucapcloud-ccip-ucap-cas

工程的工作空间内，将war发布到203.44:8180的tomcat。

在ucapcloud-services工程中，增加构建后操作-build other projects：ucapcloud-ccip-ucap-cas。

构建时，只需构建ucapcloud-services，ucapcloud-services构建完成后，会自动构建ucapcloud-ccip-ucap-cas。

3.3基于指定构建版本打SVN Tag

在“Build History”中选择进入相应的版本，并点击“Tag this build”，输入tag

地址和注释，并选择“Credentials for tagging”，最后点击【tag】按钮。

查看SVN，在tags目录下生成如下目录：

3.4基于选择SVN的TAG自动化构建

在项目的General中勾选参数化构建，添加List Subversion tags(and more)参数：

源码管理Repository URL中调用定义的参数：

构建时，点击Build with Parameters，选择tag构建。