Gitee + Jenkins

Posted 2021-06-11

一、Jenkis的准备

 

1、安装Jenkins

有一键安装包（网盘有安装包）。

.jenkins 这个文件必须要放在C:\\Users\\用户名这个目录下

 

2、打开Jenkins

在安装Jenkins路径位置输入cmd，打开命令窗口。

输入命令：java -jar jenkins.war --httpPort=8090   这里的8090是端口号，没被占用的即可

 

 Jenkins服务启动后，在浏览器输入 http://localhost:8090 打开Jenkins。用户名/密码=admin/admin

 

 

二、Gitee关联Jenkins

1、简单关联

步骤1、在Jenkins新建Item：Jenkins的左侧菜单栏找到“新建Item”

 

 步骤2、输入任务名称，选择Freestyle project，点击【确认】按钮。

　　目前Freestyle project已经够用了，其他有时间再研究

 

 步骤3、上一步跳转到新的页面，点击“源码管理”，如果代码在本地，默认选项“无”，这里我们用Git举例

 

 

 

 步骤4、把gitee的仓库链接复制到Repository URL，Credentials是gitee的登录信息，第一次使用，要在【添加】那里填写资料。填写用户名和密码为gitee的登录用户名和密码，描述为别名。添加后就可以在Credentials的下拉表找到了。

 

 

 

 

 

步骤5、暂时不考虑分支，其他设置先不设，点击保存。新建Item成功

步骤6、点击左侧菜单的 Build Now（立即构建），将运行这个item，运行完后，在本地可以查看两个地方

 

 步骤7、查看结果

查看地方1：C:\\Users\\ZH000\\.jenkins\\jobs  这里可看job的运行结果

查看地方2：C:\\Users\\ZH000\\.jenkins\\workspace  在Jenkins build now时，需要从gitee拉取代码到这个位置（可配置）

注意C盘空间大小，定期清理这来两个文件夹里的项目

在Jenkins可以配置参数，也能查看更多构建结果。

 

2、立即构建 / Build Now

在Jenkins运行项目有两种方法：一种是想运行时，手动点击Build Now，另一种是在配置里设置定期自动运行（详见下面介绍）。 

 

三、Jenkins配置更多参数

在新建Item时，就可以详细的进行配置。也可以简单新建Item后，在左侧菜单栏选择配置，慢慢配置。

 

1、清除旧构建记录

 配置 -> General 下的 Discard old build可以填保留多少天内的构建记录，也可以填保留多少个构建记录。超出范围的都将被清掉，减少空间占用

 

 

2、自定义workspace （工作空间）

Jenkins默认workspace在C:\\Users\\ZH000\\.jenkins\\workspace ， 也可自己换成D盘或其他位置。构建时就会找这指向位置的代码来运行

 

 3、定期构建

配置 -> 构建触发器 下的 Build periodically

公式：

MINUTE HOUR DOM MONTH DOW

举例：

0 10 * * *       ---- 每天10点整构建

H 10 * * *       ---- 每天10点任意分钟构建

0 10 * * 1-5   ---- 周一到五的每天10点整构建

0 10,14 * * 1-5  ----- 周一到五的每天10点和14点各构建一次

0 10 * * 1-5/2   ---- 周一到五的每2天的10点整构建

0 9-18/3 * * *   ---- 每天9点到18点之间每隔3小时构建一次

要求：Jenkins服务器开启，测试系统在线，定时构建才能生效

 

 4、源码有更新触发定期构建

配置 -> 构建触发器 下的 Poll SCM

用法同Build periodically一样，区别在于

　　Build periodically只要设置时间一到，就会构建

　　Poll SCM先判断源码有无更新，如果有就会构建，否则跳过此次构建。

 

 

 

 5、构建步骤：执行命令。运行一个项目，只需运行入口文件main.py。这里添加的命令(python main.py)，相当于构建的时候只需运行入口文件

配置 -> 构建操作步骤下的选项有Execute windows batch command是window的命令语句，Execute shell则是Linux的命令语句

 

 如图两个命令，一是切换到代码路径，二是运行项目里的main.py文件。当workspace和项目源代码是同一个位置时，不需要切换路径，直接python main.py即可

相当于用cmd运行项目

 

 

6、构建后步骤：html report

这个报告不好看，下面有介绍allure report

配置 -> 构建后操作步骤下的选项Push HTML reports

 

HTML directory to archive 存放report的路径，相对于workspace

Index page[s]  文件名

 

 

 

 在  Manage Jenkins->Script console  执行  System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")  然后在Build Now，HTML report会好看些。

 

 

 

 

7、Email notification

 配置过程待完善

在构建完成后，可以通过配置邮件发送HTML通知大家。

 

 

 

Jenkins插件下载地址：http://updates.jenkins-ci.org/download/plugins/