Jenkins的安装及配置

1. 安装及配置

1.1 下载Jenkins

1. 打开官网：https://www.jenkins.io/zh/， 点击【下载】按钮，如下图所示:

 　　

 

 

 　　2.进入Jenkins下载页面，选择相应的操作系统类型进行下载即可，本文档主要是以Windows系统为例,因此点击[windows]链接进行下载,如下图所示：

 　　

 

 

 

3.下载完成后，将会获取到jenkins.msi安装文件.

注意：如果未下载成功，也可以使用以下方法进行下载.

 

 

 

 

1.2.安装Jenkins

　　1.直接点击下载文件jenkins.msi，开始进行安装，如下图所示:

 　　　　

 

 

　　 2.点击[next],选择Jenkins安装目录，如下图所示，选择后点击[next]

 　　　　

 

 

 　　选择Logon Types为[Run services as LocalSystem (not recommended)]即可,点击[next]即可.如下图所示：

　　　　

 

 

 

 

1. 进入端口选择界面，端口设置为可用的端口即可,本例选择端口为9199，点击[Test Port]验证端口是否可用，如果可用直接点击[next]即可.

　　

 

 

 

 

1. 选择Jdk安装路径(注意：如果没有安装jdk环境，必须先安装好JDK环境及设置好相应的环境变量)，点击[next],如下图所示:
2. 

    

    

    

1. 如下图所示，将鼠标移到FileWall Exception上面点击,选择[Will be installed on local hard drive],也可以保持默认,点击[next].

 

 

 

 

1. 点击[install]开始安装

 

 

 

 

1. 在安装过程中如果提示需要权限等信息，请选择[是]或者[允许]，安装完成后如下图所示，点击[Finish]完成安装。
2. 

    

    

 

1.3配置Jenkins

1.上图点击完[Finish]按钮后，会自动打开网页http://localhost:9199/,如下图所示.

注意：此处localhost，即为本机的ip地址127.0.0.1，外网使用外网ip地址即可.

 　　

 

 

 

1. Jenkins初始化完成后,进入如下界面:

 　　

 

 

 

1. 到上图指定的文件目录的文件中copy初始密码，填入[管理员密码]输入框中，如下图所示：

 　　

 

 

 

点击[继续]按钮，进行初始化即可，等待运行完成后，如下图所示.

 

 

 

 

2.点击[安装推荐的插件]，等待依耐安装完成,如下图所示.

 

 

 

 

注意：如果出现部分插件安装失败，如下图所示，点击[重试]按钮，直到所有插件都安装成功为止.

 

 

 

 

3.创建第一个管理员用户，输入相应的信息，点击[保存并完成]执行下一步.

 

 

 

 

4.实例配置.

注意：此处默认即可，需要记住这个URL链接，此链接即为Jenkins站点链接。

 

 

 

 

5.点击[开始使用Jenkins].

 

 

 

 

6.Jenkins主界面，首页.

 

 

 

 

2. 管理Jenkins(Manage Jenkins)

点击[Manage Jenkins],进入管理Jenkins界面,如下图所示：

 

 

 

 

2.1用户管理(Manage Users)

2.1.1新增用户

1.[首页]->点击[Manage Jenkins]->点击[Manage Users]->点击[新建用户]进入新建用户界面，如下图所示.

 

 

 

 

1. 输入相应的信息即可新增用户信息,后续的项目集成可以使用创建的用户进行.

2.1.2 用户列表

1.系统管理员在用户列表界面可以管理用户信息，如下图所示.

 

 

 

 

2.2安装插件(Manage plugins)

2.2.1安装Maven插件

1.[首页]->点击[Manage Jenkins]->点击[Manage plugins]进入插件管理界面，如下图所示.

 

 

 

 

 

2.点击[可选插件],输入maven，确认即可搜索出Maven插件,选择如下图所示插件，

 

 

 

 

 

 

 

注意：只有安装了Maven Integration插件才可以构建Maven项目.

3.点击[Install without restart],安装插件.

4.同样的方法安装[Subversion]插件，如下图所示.

 

 

 

 

5.可以使用同样的方法安装其他插件.

6.安装成功的提示信息,如下所示：

 

 

 

 

 

2.2.2重启Jenkins

1.在浏览器地址栏输入网址：http://localhost:9199/restart，回车

 

 

 

 

注意：安装了新插件以及后面修改了系统配置信息，最好是重启下Jenkins,确保正常使用.

2.3 系统配置(System configuration)

2.3.1 配置系统(Configure System)

1.[首页]->点击[Manage Jenkins]->点击[Configure System]进入配置系统界面，如下图所示：

 

 

 

 

例如：全局MAVEN_OPTS配置：-Xmx8192m -XX:MaxPermSize=8192m

注意：

Jenkins默认的数据存储目录为：

C:\WINDOWS\system32\config\systemprofile\AppData\Local\Jenkins\.jenkins

如果想修改默认的数据存储目录，请在安装Jenkins前先设置一个JENKINS_HOME目录作为Jenkins的数据文件存储目录，这样后续的文件都在你配置的目录下操作，方便管理.，如下图所示：

 

 

 

 

2.3.2 全局工具配置(Global Tool Configuration)

点击[Dashboard]à[Manage Jenkins]à Global Tool Configuration 进入全局工具配置界面，如下图所示：

 

 

 

 

1.Maven环境配置.

此配置主要是配置Maven安装目录下settings文件的路径.

 

 

 

 

注意：此配置以本机实际的Maven目录为准.

注意：项目Maven编译构建的项目Settings需要做特殊的配置，因为一些Jar文件外网环境并不一定存在，因此统一使用内网环境下载的jar文件进行构建

 

注意：在Build项目拉取Maven仓库时，如果查看控制台输出是如下所示，才表明配置生效.

 

1. JDK配置

注意：JAVA_HOME指定为java的安装目录.

 

 

 

 

1. Maven配置.

此配置主要是配置Maven安装目录的路径.

 

 

 

 

注意：在系统配置步骤的每个阶段，修改配置后及时先点击应用再点击保存,如下图所示：

 

 

 

 

 

3. 项目集成

3.1新建项目

[首页]-->点击[新建item]开始新建集成项目，进入如下界面：

 

 

 

 

输入一个任务名称,例如：Freeview_Application，选择“构建一个maven”项目,点击[确定],进入下一个页面.

注意：没有成功安装Maven插件的Jenkins默认是没有[构建一个maven项目]选项.

注意：新建项目时必须按照项目的构建顺序进行构建，如医护3.0项目的构建顺序如下:

 

如果不按此构建顺序，在build时会出失败。

3.2项目配置

3.2.1 Global

 

 

 

 

注意：以上信息可以不写，保留默认即可.

3.2.2 源码管理

 

 

 

 

 

注意：Local module directory 可以设置为需要的目录，本文档主要以根目录为例，如果使用了新的目录，后面maven选择pom.xml时注意指定为正确的目录即可.

添加svn账号：

 

注意：svn下载源码的默认目录为：

C:\Windows\System32\config\systemprofile\AppData\Local\Jenkins\.jenkins\workspace

注意：修改、删除svn账号方法，到如下目录删除相应的账户信息即可.

 

 

3.2.3 构建触发器

 

 

 

 

3.2.3.1 构建策略

使用Jenkins构建项目，可以使用定时构建和轮询构建:

Build periodically和Poll SCM可以设置定时自动构建。两者区别如下

1. 区别

[1].定时构建(Build periodically):

不管远程代码分支上(Svn/Git)的代码有无更新，均执行定时构建任务.

[2].轮询SCM(Poll SCM):

远程代码分支上(Svn/Git)只要有任何更新，则执行构建任务.

1. 格式:* * * * *

第一颗*表示分钟minute：取值0-59，第几分钟执行

第二颗*表示小时hour：取值0-23，第几小时执行

第三颗*表示日day：取值1-31，第几日执行

第四颗*表示月month：取值1-12，第几月执行

第五颗*表示星期week：取值0-7，每周第几天执行

1. 实例

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3.2.4 构建环境

保持默认即可，也可勾选相应的选项进行相应的处理.

 

 

 

 

3.2.5 Pre steps

保持默认即可。

 

 

 

 

也可以执行一些其他操作，如执行一些windows批处理命令，shell脚本等，如下图所示：

 

 

 

 

3.2.6 Build

 

 

注意：此处选择需要构建pom.xml，路径要选择正确,否则无法编译.

 

 

 

 

3.2.7 Post steps

保持默认即可，如下图所示：

 

 

 

 

也可以执行一些其他操作，如执行一些windows批处理命令，shell脚本等，如下图所示：

 

 

 

 

3.2.5 构建设置

保持默认即可，如下图所示：

 

 

 

 

也可以勾选后，输入通知email地址，选择通知规则即可,如下图所示：

 

 

 

 

3.2.5 构建后操作

 

构建后操作是构建完一个项目后，再接着构建另外一个项目，可以形成一条构建链,在配置构建项目初始，可以不配置此项信息，当所有要构建的项目均已配置完好后，再修改此配置信息,否则无法进行选择。

 

 

 

 

 

 

 

 

 

注意：构建后项目选择一个即可，如项目

FV_Application的构建后操作，要构建的项目是Framework

Framework的构建后操作，要构建的项目是Medical.Platform

3.3项目构建

3.3.1 Build Now

新建完项目，并在项目配置完成后，就可以进行项目的构建[Build Now],如下图所示：

 

 

 

 

点击[Build Now],就可以进行项目构建,在[Build History] 构建历史列表中有构建的历史列表显示.

 

 

 

3.3.2控制台输出

如上图所示，点击[#1]就可以查看项目实时构建情况,如下图所示：

 

 

 

 

 

4.问题总结

4.1 Jenkins构建时报内存溢出问题

错误java.lang.OutOfMemoryError: Java heap space，问题出现的原因时Maven构建的项目太多，容易引起内存溢出的问题.

 

 

 

4.2 Maven 配置不生效问题

 

 

 

 

在使用Maven配置文件时，尽量使用默认的文件名，如settings.xml文件作为配置文件，不要使用别的文件名作为Maven的配置文件,以防配置不生效.

 

4.3 项目配置不生效问题

在配置项目或构建过程中发现配置不生效，则重启下Jenkins,在浏览器地址栏执行

http://localhost:9199/restart即可.

4.4 项目构建顺序

 

新建项目时必须按照项目的构建顺序进行构建，如项目的构建顺序如上所示，不按照项目本身的构建顺序进行构建，项目的构建中途会失败.