windows系统下jenkins环境搭建与基本使用

一. windows 系统下搭建jenkins环境

1.1 jenkins环境搭建和构建job流程图

1.2 安装jdk

JDK下载地址： http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

选择对应系统的安装包下载：

配置环境变量:

新建JAVA_HOME系统环境变量，变量值处输入JDK安装目录，如 "D:\Program Files\Java\jdk1.8.0_66"

新建CLASSPATH变量，变量值为".;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar"

修改Path变量，在最后添加";%JAVA_HOME%\bin"

在cmd中输入"java -version"，有版本信息返回，说明已添加成功

1.3 安装tomcat

官网下载地址： http://tomcat.apache.org/

Tomcat 官方网站：http://tomcat.apache.org/，打开后首页如图所示

单击页面左侧 Tomcat 版本进行下载，对下载的压缩包进行解压，目录结构如图所示

通常将需要运行的应用放到 webapps/目录下，进入 bin/目录下，双击 startup.bat，启动Tomcat 服务器。

1.4 安装jenkins

Jenkins 官方网站：http://jenkins-ci.org/，找到对应版本下载

下载完成，双击进行安装，注意:在选择安装目录时，指定安装到 Tomcat 的 webapps\目录下，如图所示:

进入 Tomcat 的 bin/目录下启动 startup.bat ，通过浏览器访问：http://localhost:8080/jenkins/，进入jenkins主页。

1.5 修改jenkins的工作目录

默认情况下，jenkins的工作空间会放到C:\Users\Account\.jenkins目录下，如过想要更改工作空间，我们需要在系统环境变量里面配置JENKINS_HOME变量，将该变量指向目标工作空间。这里需要注意的是，tomcat启动情况下，jenkins不会去读JENKINS_HOME变量，必须要重启tomcat。而重启tomcat也是有坑的，如果tomcat是通过命令行执行tomcat/bin/startup.bat目录启动的，那么单单停掉tomcat没用，必须要将前面提到的命令行一并关闭掉，这时重启tomcat，jenkins才会使用JENKINS_HOME中配置的目录作为工作空间。此外，一旦更换工作空间，此前关于jenkins的所有配置都将作废。

在windows下修改默认工作空间的方法:

增加系统变量JENKINS_HOME，指向想要更改的Jenkins默认工作空间。比如，我想设置E:\jenkins_workspace为Jenkins的默认工作目录，那么在系统变量中，设置JENKINS_HOME为E:\jenkins，再重启jenkin即可。

1.6 jenkins的插件安装

安装jenkins插件有两种方法,一种是在线安装,一种是离线安装.两种方式介绍如下:

1.如果服务器可以上网,那边选择在线安装最好不过了,安装流程为:
系统管理----插件管理---选择需要的插件直接安装即可

2.如果服务器不能上网,那么就只能离线安装,首先去http://updates.jenkins-ci.org/download/plugins/下载需要的plugin,选择匹配的版本号,下载到本地,然后打开:系统管理---插件管理—高级---找到”上传插件”(浏览,找到扩展名为.hpi或者.jpi的插件，上传之后默认直接就安装了。重启jenkins，安装的插件就可以使用了。

1.7 构建一个简单job——执行python自动化测试框架脚本

步骤1:禁用jenkins作为windows 服务

如果大家需要将基于selenium或pywinauto等库编写的自动化测试框架集成在jenkins中，那么测试框架的脚本要正常运行，需要先禁用jenkins作为windows 服务，否则会出现无法正常启动浏览器，无法正常打开测试APP并定位到待测窗口，禁用方法如下:

在window搜索框中搜索"服务"管理工具，打开后找到jenkins,点击"右键"->属性->"启动类型"改为"禁用"->点击确认，如下图所示。

禁用后，由tomcat启动jenkins，启动方法:进入 Tomcat 的 bin/目录下启动 startup.bat ，通过浏览器访问：http://localhost:8080/jenkins，进入jenkins主页。

其他情况下，可以不禁用jenkins为windows服务。

步骤2：安装插件

回到Jenkins初始界面，在左侧菜单栏找到系统管理
进入系统管理界面后，点击管理插件
点击可选插件选项，在右上角搜索框搜索以下插件，点击安装即可:

SSH plugin：远程ssh登录server执行命令
Parameterized Trigger Plugin：触发其他的job
python plugin ：支持python脚本的运行
Git Plugin：使用Git作为源代码管理
htmlpublisher：用于构建后生成html报告
log parse：解析Jenkins构建生成的控制台日志
Groovy :执行系统 Groovy 脚本，此处用于解决jenkins上的html文件丢失样式

也可以下载安装包，在高级选项下根据提示安装

步骤3：配置系统设置

　　1.配置Jenkins Location和系统管理员邮件地址，如下图:

　　2.配置邮箱:注意这里的发件人邮件地址需与管理员邮件地址一致，否则无法正常发送邮件，以qq邮箱配置为例，配置如下:

　配置完成后，勾选"通过发送测试邮件测试配置，输入收件邮箱地址，点击Test configuration，测试配置邮箱是否能正常发送邮件　

　　3.配置log parse,其中logparse rules如下所示:

ok /not really/

# match line starting with 'error ', case-insensitive

error /error /

# list of warnings here...

warning /[Ww]arning/

warning /WARNING/

# create a quick access link to lines in the report containing 'INFO'

info /INFO/

# each line containing 'BUILD' represents the start of a section for grouping errors and warnings found after the line.

# also creates a quick access link.

start /BUILD/

rule的具体规则语法可以使用正则表达式，具体可以参考Log Parser插件的文档http://my.oschina.net/donhui/blog/382592，Parsing Rules File的配置同上文的配置工作目录具有一样的坑，如果要更新规则，首先要清除job中选中的规则，然后删除此处配置的Parseing Rule，重启tomcat。

步骤4：全局工具配置

　　1.配置JDK，点击新增JDK，将自动安装复选框的对勾去除，手动添加别名和JDK安装路径，如下所示:

　　2.配置git，将自动安装复选框的对勾去除，手动添加别名和git安装路径，如下所示:

步骤5:构建第一个python的job

回到Jenkins初始界面，在左侧菜单栏找到新建任务
输入任务名称，构建一个自由风格的项目
对项目进行配置:

<1>general配置:

　　　　<2>源码管理配置

如果还没有添加访问git的证书，先点击下图中的add，配置访问git的key。这个key跟我们在gitHub中配置公有秘钥的道理是一样的，jenkins调用git命令去Git服务器上pull代码，git服务器通过检查公钥私钥来保证安全性。如果机器上没有git的ssh key需要通过下面的命令自己手动生成一个。

$ ssh -keygen -t rsa -C "xxxxxxxxxx@qq.com" （创建SHH KEY）

点击add后，详细配置如下图:

　　 <3>构建执行脚本

windows批处理命令详解请看博文:https://www.cnblogs.com/dongzhuangdian/p/5510941.html

　　　　<4>构建后配置如下:

　　　配置console output parsing:

　　　　配置输出html报告:

1.8 解决jenkins上显示的测试报告css样式丢失

永久解决css样式丢失方法如下：

jenkins上安装 Groovy 插件，用来执行系统 Groovy 脚本，安装完成后，在增加构建步骤里添加：
Execute system Groovy script

执行脚本：System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")

把脚本执行集成在项目中，这样就不用担心Jenkins重启了。

>>>>>>待续