1、创建 job
1)启动 Jenkins 后在首页点击”开始创建一个新任务”。
2)输入任务名称,选择自由风格,点击“确定”。
2、构建保持配置
1) 任意输入描述,然后勾选”丢弃旧的构建”, 在”保持构建的最大个数中”输入 3。
由于 Jenkins 构建产生的日志等信息会保存在本机磁盘中,这样无限构建任务的话就会占用很多磁盘空间,因此可以在这里对旧的构建进行配置丢弃,可以选择以天数为条件,也可以选择保持的个数,这里就以保持 3 个构建数为例。
3、参数化设置
1)勾选”参数化构建过程”,选择添加”字符参数”
2)设置参数名称、默认值和描述
4、定时构建
1)在”构建触发器”中勾选”定时构建”,日程表中输入H2/ * * * *,表示每两分钟构建一次。
5、Execute Shell
1)在构建中选择执行 shell,简单的执行一条打印语句,打印上面设置好的参数param;设置好之后保存即可。
6、结果展示
- 可以看到构建结果是每 2 分钟构建一次,且只保留最近的 3 次构建,参数 param使用了默认值Jenkins。
- 打开控制台输出可以看到执行的日志信息。
- 如果想要修改参数值,选择Build with Parameters,修改参数,点击开始构建即可。
7、补充说明
7.1 定时构建时间描述
在上述设置定时构建时,输入了一行命令H2/ * * * *来表示每隔 2 分钟构建一次,这是一种crontab的写法,具体描述分五个部分:
分钟 小时 日期 月份 星期几
* * * * *
- - - - -
| | | | |
| | | | +----- 星期中星期几 (0 - 7) (星期天 为 0 或 7)
| | | +---------- 月份 (1 - 12)
| | +--------------- 一个月中的第几天 (1 - 31)
| +-------------------- 小时 (0 - 23)
+------------------------- 分钟 (0 - 59)
- 星号(*):代表所有可能的值,例如 month 字段如果是星号,则表示在满足其它字段的制约条件后每月都执行该命令操作。
- 逗号(,):可以用逗号隔开的值指定一个列表范围,例如,“1,2,5,7,8,9”。
- 中杠(-):可以用整数之间的中杠表示一个整数范围,例如 “2-6” 表示 “2,3,4,5,6”。
- 正斜线(/):可以用正斜线指定时间的间隔频率,例如 “0-23/2” 表示每两小时执行一次。同时正斜线可以和星号一起使用,例如 */10,如果用在 minute 字段,表示每十分钟执行一次。
但是实际在 Jenkins 中进行定时构建时,写法相似但是还是有区别,还是以上述的H2/ * * * *来表示每隔 2 分钟为例,当我们用*/2 * * * *写法时:
可以看到 Jenkins 建议我们使用H来代表通配符,因此在表示每隔多久时建议使用H/的方式。
另外,如果表示每天上午 9 点构建,如果使用0 9 * * *:
可以看到 Jenkins 建议我们使用H 9 * * *的方式:
下面是一些常用定时方式的参考示例:
- 每 30 分钟构建一次:H/30 * * * *。
- 每 2 小时构建一次:H H/2 * * *。
- 每天早上 9 点构建一次:H 9 * * *。
- 每天 8 点、12 点、21 点各构建一次:H 8,12,21 * * *。
- 周一至周五,每天 22 点到 23 点之间每隔 3 分钟构建一次:H/3 22-23 * * 1-5。
7.2 时间不一致
7.2.1 现象原因
运行完毕后,会发现一个问题,构建的时间与我们实际的时间不一致:
- Jenkins 显示时间
- 系统实际时间
因为我们是用 Docker 部署的,所以再通过打印 Docker 容器的时间进行查看:
jenkins@0520b8208ffb:/$ date
Fri Apr 10 01:35:30 UTC 2020
jenkins@0520b8208ffb:/$ exit
exit
xxxdeMacBook-Pro:jenkins_home xxx$ date
2020 年 4 月 10 日 星期五 09 时 35 分 35 秒 CST
再进入”系统管理”->”系统信息”->”user.timezone”查看:
综上所述可以确定因为 Jenkins 容器使用的是 UTC 时间,和我们的北京时间差了正好 8 个小时,针对我们是 Docker 部署的,解决方法如下 (其他直接在系统部署的可以另行百度~)。
7.2.2 解决方法
在 Jenkins 容器启动的时候添加参数
$ docker run ... -e JAVA_OPTS=-Duser.timezone=Asia/Shanghai
启动后再次查看”系统管理”->”系统信息”->”user.timezone”,发现时区已修改为上海:
查看构建历史,发现时间已于系统时间保持一致,修改完成: