目录
前言:
以下是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构建:
在此就实现了参数化构建了