jenkins内部参数传递

场景一: Job构建步骤间的变量传递
Jenkins提供了数十种构建方式,我们以最常用的『Execute shell』为例。有时为了使Job中的复杂的构建流程更加清晰我们配置多个构建步骤像下面这样。图中包含两个构建步骤,步骤2需要根据步骤1中的返回值来判断是否执行操作:
[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team
执行时jenkins将两个构建步骤生成两个shell文件,然后分别调用。

do_build_step_1

[Jenkins] $ /bin/bash -xe /tmp/hudson1270042613896791809.sh
do_build_step_2

[Jenkins] $ /bin/bash -xe /tmp/hudson5918908417824291692.sh
理论上两个shell之间是无法通信的,step1执行完之后变量$dostep2就会被回收,要注意试图在step1中通过export或者其他脚本方式注入环境变量都是无效的。
解决方案:读写文件
要实现它们之间的变量传递只能通过读写文件的方式。我们有一个真实应用场景是这样的,配置由git push触发编译任务,但是并不是每一次git的提交都需要触发编译,比如说只有前端代码的提交其实并不影响编译的结果,我们只好在step1中加入判断来却确定step2是否真的有必要被执行。
[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team
场景二: Job之间的变量传递
现在有两个Project『run_compile』和『run_deploy』,代码编译成功后开始执行环境部署。不需要传递参数的情况下可以选择“Build other projects“的方式。
[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team
需要传递参数则需要选择”Trigger parameterized build on other projects”的方式。

[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team

Jenkins Parameterized Trigger plugin可以实现Job间参数传递但是有局限性,我们只能选择传递当前build的参数或者环境变量。 (例:$GIT_COMMIT是git plugin提供的一个变量,存着当前build触发时最新的git code.) 如果要传递一个自定义的变量怎么办呢? 构建步骤中的自定义变量在执行结束后都会被回收,我们不可能在”predefined parameters”中取到。
依旧以编译任务为例,前端代码的提交不需要触发编译,没有编译也就不需要执行接下来的『run_ut』单元测试。(泛指后台代码的UT, JS UT这种稀有存在暂不考虑)
如何将编译的状态告诉下游的单元测试呢?
聪明的你想起了场景一的解决办法。对,我们也可以通过读写文件的方式来解决这个问题嘛!
不过这里我不推荐大家采用这种方式,理由有两点:
一,『run_compile』和『run_ut』有可能被部署在不同slave上,如果考虑更加智能的CI配置方式会在构建时动态的选择空闲的slave去执行,这种文件读写的方式就有了很大的局限性;
二,很难确保文件传递的准确性,如果『run_compile』写入文件失败,『run_ut』中读到的就是一个旧值一个不准确的值。
解决方案一:通过properties file的方式传递参数。
首先将变量以”xx=xx”的样式写入到配置文件『propfile.txt』中。
[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team
然后在”Trigger parameterized build on other projects”中选择”Parameters from preperties file”,在propfile里写入多个变量就可以传递多个值。
[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team

建议勾选”Don’t trigger if any files are missing”和删除旧文件配合使用。

最后在『run_ut』中可以直接获取这个变量来使用了。
[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team
解决方案二: 通过EnvInject Plugin插件
EnvInject Plugin可以支持修改、注入和删除环境变量。
我们在构建中增加步骤”Inject environment variables”, 将写在配置文件中的变量${IFUT},注入到环境变量里。
[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team
这样在”Trigger parameterized build on other projects”就可以直接选择”predefined parameters”方式直接传递变量了。同样的在Job『run_deploy』里就可以直接访问变量${IFUT}了。
[Jenkins]Job中如何传递自定义变量 - 网易杭州QA - 网易杭州 QA Team

本次要分享的内容就这么多。

最后有一个槽点:
为什么jenkins不支持根据条件判断来决定是否触发下一个Project呢?
实际上我最希望的是当ifut=false的时候就直接不触发『run_ut』,『run_ut』不被触发也就省去了不少无用功。

发表评论

电子邮件地址不会被公开。