学习是自我的事,自我的事应当自我做好

Jenkins是一款流行的开源持续集成(CI)工具,广泛用于项目开发,具有自动化构建、测试、部署等功能。在Jenkins中提供了很多参数类型,在此整理了一些常用的参数使用。

首先我们需要知道Jenkins中的参数需要在哪里进行设置,

General——>This project is parameterized

jenkins JNLP方式 jenkins parameter_jenkins JNLP方式


当点击Add Parameterized时,会看到所有的参数类型。

jenkins JNLP方式 jenkins parameter_jenkins JNLP方式_02


在Jenkins中提供了很多类型的参数,在此介绍以下几种

  • String Parameter
  • Boolean Parameter
  • Choice Parameter
  • Extended Choice Parameter
  • File Parameter
  • Git Parameter

1. String Parameter

字符串类型

Name中我们可以输入变量的名字,这个参数可以作为环境变量使用,Default Value中可以为空,也可以输入一个默认值,在Description中比较随意,根据自己的需求进行填写,用于提示。Trim the string修建字符串,从字符串的开头和结尾去掉空格,不过我试了一下,无论是否☑️这个,结果都是一样的,所以这个选项无关紧要。

jenkins JNLP方式 jenkins parameter_jenkins JNLP方式_03


可在build中写入脚本,输出Description的值。

例如:

jenkins JNLP方式 jenkins parameter_Jenkins参数使用_04


接下来进行构建

jenkins JNLP方式 jenkins parameter_Jenkins_05


然后在控制台中,我们会看到日志信息。

2. Boolean Parameter

布尔类型,该类型可以用于判断,假如 我们希望构建的产物可以上传到某个存储里面,那么我们可以这样设置,如下图,其中Name见文知意即可,Default Value如果☑️的话,默认为true

jenkins JNLP方式 jenkins parameter_Jenkins中选择类型_06


在build脚本中,可以加一个判断

jenkins JNLP方式 jenkins parameter_Jenkins_07


可以根据需求进行构建

jenkins JNLP方式 jenkins parameter_Git 参数类型_08

3. Choice Parameter

需要注意的是,在Choices中,一行代表一个选项,展示如下

jenkins JNLP方式 jenkins parameter_Jenkins中选择类型_09


可以根据选项进行构建,单选类型

jenkins JNLP方式 jenkins parameter_Jenkins中选择类型_10

4. Extended Choice Parameter

在扩展性选择参数类型中,提供了多种参数类型,小编在此将参数类型分为两类:

  • 单选
  • Single Select
  • Radio Buttons
  • 多选
  • Multi Select
  • Check Boxes

jenkins JNLP方式 jenkins parameter_Git 参数类型_11


下面对这四种类型进行介绍

4.1 Single Select

单选类型,这个使用方式和Choice Parameter提供的方式一样,需要注意的是在Choose Source for Value中,Value中的值需要用英文逗号进行隔开,代表是一个选项。最终展示的结果和Choice Parameter是一致的。

jenkins JNLP方式 jenkins parameter_Jenkins_12

4.2 Radio Buttons

该参数类型提供了单选按钮,也可以将我们设置的选项全部展示出来,推荐使用

jenkins JNLP方式 jenkins parameter_Jenkins_13

4.3 Multi Select

如果想选择多个,则使用Multi Select参数类型,结果展示如下

jenkins JNLP方式 jenkins parameter_Jenkins中选择类型_14

4.4 Check Boxes

复选框展示结果如下图,推荐使用

jenkins JNLP方式 jenkins parameter_Jenkins_15

5. File Parameter

关于文件参数类型,可以参考小编的另外一篇博客
File Parameter参数的使用

6. Git Parameter

Git Parameter中,参数类型有以下几种,在此主要列举三种:

  • Tag
  • Branch
  • Branch or Tag

    选择任意一种之后,我们需要在 Source Code Management中的Branches to build中输入变量名

    注意:
  1. 当未选择Git参数时,Branches to build中的默认值为 */master
  2. 当选择Git参数后,Branches to build中的值需要输入变量 ${变量名}

展示结果如下,我们可以选择任意一个分支构建。Branch和Tag的使用是一致的,在此不做赘述。

jenkins JNLP方式 jenkins parameter_Git 参数类型_16

题外篇

Branches to build中参数的书写
Source Code Management中的Branches to build中,有三种方式:

  • 默认值,默认值为:*/master
  • 分支固定
  • Tag触发
  1. 如果想要固定其他分支进行构建,写法如下
refs/heads/BranchName

jenkins JNLP方式 jenkins parameter_Jenkins中选择类型_17

  1. Tag触发
    通过GitHub中的Tag进行触发Jenkins构建
**/tags/**