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

时间:2021-12-17 12:03:17

一. windows 系统下搭建jenkins环境

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

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

1.2 安装jdk

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

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

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

配置环境变量:

新建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/,打开后首页如图所示

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

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

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

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

1.4 安装jenkins

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

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

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

进入 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即可。

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

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服务。

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

 

步骤2:安装插件

  1. 回到Jenkins初始界面,在左侧菜单栏找到系统管理
  2. 进入系统管理界面后,点击管理插件
  3. 点击可选插件选项,在右上角搜索框搜索以下插件,点击安装即可:
  • 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和系统管理员邮件地址,如下图:

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

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

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

     配置完成后,勾选"通过发送测试邮件测试配置,输入收件邮箱地址,点击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/

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

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

     步骤4:全局工具配置

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

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

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

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

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

    1. 回到Jenkins初始界面,在左侧菜单栏找到新建任务
    2. 输入任务名称,构建一个*风格的项目
    3. 对项目进行配置:
    4. <1>general配置:

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

        <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)

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

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

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

            <3>构建执行脚本

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

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

        <4>构建后配置如下:

        配置console output parsing:

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

        配置输出html报告:

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

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

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

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

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

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

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

    >>>>>>待续