Jenkins 参数化构建

目录

前言：

以下是Jenkins官方的介绍：

首先新建一个自由风格的job，然后勾选“This project is parameterized”，如下图：

勾选参数构建

choice parameterized：

选项：

使用参数：

添加构建步骤

Windows构建脚本

测试验证

---

前言：

很多时候我们需要根据不同的条件去执行构建，如自动化测试中执行sit、uat、prd环境的构建，Jenkins是支持参数化构建的。

以下是Jenkins官方的介绍：

参数允许您提示用户输入一个或多个将传递到生成中的输入。例如，您可能有一个项目，它允许用户上传一个包含要测试的二进制文件的zip文件，从而按需运行测试。这可以通过在此处添加文件参数来完成。
或者，您可能有一个发布某些软件的项目，并且您希望用户输入将与软件一起上传的发布说明。这可以通过在此处添加一个多行字符串参数来完成。
每个参数都有一个名称和某种值，具体取决于参数类型。当生成开始时，这些名称-值对将作为环境变量导出，从而允许生成配置的后续部分（如生成步骤）访问这些值，例如使用$｛PARAMETER_name｝语法（或Windows上的%PARAMETER_NAME%）。
这也意味着这里定义的每个参数都应该有一个唯一的名称。

当项目被参数化时，通常的“Build Now”链接将被“Build with Parameters”链接所取代，在该链接中，用户将被提示为每个定义的参数指定值。如果他们选择不输入任何内容，则构建将从每个参数的默认值开始。

如果生成是自动启动的，例如，如果由SCM触发器启动，则将使用每个参数的默认值。

当参数化生成在队列中时，只有当参数值不同，或者启用了“必要时执行并发生成”选项时，尝试启动同一项目的另一个构建才会成功。

有关此功能的详细信息，请参阅参数化构建文档。

首先新建一个自由风格的job，然后勾选“This project is parameterized”，如下图：

 上图使用choice parameterized参数构建，模拟不同测试环境

勾选参数构建

choice parameterized：

定义一个简单的字符串列表，提供给用户选择。，你可以在构建时使用，或者作为环境变量，或者在配置中做变量替换。

选项：

备用选项，每行一个。第一行的将作为默认选项。

其他参数大同小异

使用参数：

Linux使用$｛PARAMETER_name｝语法（或Windows上使用%PARAMETER_NAME%）。

添加构建步骤

本文使用windows系统构建

因为要判断不同的条件所以要使用条件判断，由于有的同学对批处理命令不是很熟悉，附上if的命令使用方法：

C:\Users\Administrator>help if
执行批处理程序中的条件处理。

IF [NOT] ERRORLEVEL number command
IF [NOT] string1==string2 command
IF [NOT] EXIST filename command

  NOT               指定只有条件为 false 的情况下，Windows 才
                    应该执行该命令。

  ERRORLEVEL number 如果最后运行的程序返回一个等于或大于
                    指定数字的退出代码，指定条件为 true。

  string1==string2  如果指定的文字字符串匹配，指定条件为 true。

  EXIST filename    如果指定的文件名存在，指定条件为 true。

  command           如果符合条件，指定要执行的命令。如果指定的
                    条件为 FALSE，命令后可跟 ELSE 命令，该命令将
                    在 ELSE 关键字之后执行该命令。

ELSE 子句必须出现在同一行上的 IF 之后。例如:

    IF EXIST filename. (
        del filename.
    ) ELSE (
        echo filename. missing.
    )

由于 del 命令需要用新的一行终止，因此以下子句不会有效:

IF EXIST filename. del filename. ELSE echo filename. missing

由于 ELSE 命令必须与 IF 命令的尾端在同一行上，以下子句也
不会有效:

    IF EXIST filename. del filename.
    ELSE echo filename. missing

如果都放在同一行上，以下子句有效:

    IF EXIST filename. (del filename.) ELSE echo filename. missing

如果命令扩展被启用，IF 会如下改变:

    IF [/I] string1 compare-op string2 command
    IF CMDEXTVERSION number command
    IF DEFINED variable command

其中， compare-op 可以是:

    EQU - 等于
    NEQ - 不等于
    LSS - 小于
    LEQ - 小于或等于
    GTR - 大于
    GEQ - 大于或等于

而 /I 开关(如果指定)说明要进行的字符串比较不分大小写。
/I 开关可以用于 IF 的 string1==string2 的形式上。这些
比较都是通用的；原因是，如果 string1 和 string2 都是
由数字组成的，字符串会被转换成数字，进行数字比较。

CMDEXTVERSION 条件的作用跟 ERRORLEVEL 的一样，除了它
是在跟与命令扩展有关联的内部版本号比较。第一个版本
是 1。每次对命令扩展有相当大的增强时，版本号会增加一个。
命令扩展被停用时，CMDEXTVERSION 条件不是真的。

如果已定义环境变量，DEFINED 条件的作用跟 EXIST 的一样，
除了它取得一个环境变量，返回的结果是 true。

如果没有名为 ERRORLEVEL 的环境变量，%ERRORLEVEL%
会扩充为 ERROLEVEL 当前数值的字符串表达式；否则，你会得到
其数值。运行程序后，以下语句说明 ERRORLEVEL 的用法:

    goto answer%ERRORLEVEL%
    :answer0
    echo Program had return code 0
    :answer1
    echo Program had return code 1

你也可以使用以上的数字比较:

    IF %ERRORLEVEL% LEQ 1 goto okay

如果没有名为 CMDCMDLINE 的环境变量，%CMDCMDLINE%
将在 CMD.EXE 进行任何处理前扩充为传递给 CMD.EXE 的原始
命令行；否则，你会得到其数值。

如果没有名为 CMDEXTVERSION 的环境变量，
%CMDEXTVERSION% 会扩充为 CMDEXTVERSION 当前数值的
字串符表达式；否则，你会得到其数值。

之前写也遇到坑，但是注意到这句：由于 ELSE 命令必须与 IF 命令的尾端在同一行上，以下子句也不会有效： IF EXIST filename. del filename.
    ELSE echo filename. missing
似乎是告诉我们写if语句时要在同一行，不然你运行Jenkins的时候会一直提示你语法错误。。。

后面看了下jmeter的Windows启动脚本，都是按这种方式写的：IF %ERRORLEVEL% LEQ 1 goto okay
：okay

goto END

:END

Windows构建脚本

所以最终的Windows构建脚本大概是这样的，只做演示，实际可以在不同分支中加入代码执行逻辑，如sit执行sit环境脚本，uat执行uat环境脚本。。。

if %execute_env% == debug goto debug
if %execute_env% == sit goto sit
if %execute_env% == uat goto uat
if %execute_env% == uat goto prd
:debug
echo 调试环境
goto END

:sit
echo 测试环境
goto END

:uat
echo UAT测试环境
goto END

:prd
echo 生产环境
goto END

:END

测试验证

可以看到默认是选择第一个选项的，我们选择第一个选项进行构建，然后查看构建控制台输出

 

 然后我们选择其他选项试下是否真的能够切换环境，选择sit构建：

 在此就实现了参数化构建了