释放双眼，带上耳机，听听看~！
继续来学习basic pipeline这个插件的提供的方法，本篇主要学习timeout和waitUntil两个关于时间监控的方法。有时候，我们需要对一个stage执行时间进行精确监控。例如执行这个stage大概20分钟一定可以完成，那么我们就可以使用timeout 设置20分钟，如果操作20分钟还没有执行结束，那么当前这个pipeline stage就会被自动取消，状态显示为aborted。而waitUntil是一个等待一个条件出现就会终止执行等待的方法。下面我分别用一个简单例子来代码演示。withEnv是设置环境变量的，有时候我们还会设置一些普通变量放这个位置。
1.方法timeout
叫方法或者指令都可以，timeout的基本格式如下，例如我有一个代码块执行监控执行时间，那么放在timeout(){…}就好，
2
3
4
2 // 需要监控的代码执行
3}
4
我写一个一分钟超时的简单代码。
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3println env.JOB_NAME
4println env.BUILD_NUMBER
5
6pipeline{
7
8 agent any
9 stages{
10 stage("init") {
11 steps{
12 script {
13 timeout(1) {
14 sh('java -version')
15 //sleep 61
16 }
17 }
18 }
19 }
20 }
21}
22
23
上面我没有执行sleep语句，那么这个打印java -version的代码肯定能在一分钟之内完成，这个job执行的状态是成功。那么，如果我取消sleep这个前面注释，也就是这个代码要执行61秒以上的时间，但是我给了timeout是1分钟，那么这个job跑起来就会自动cancel,状态是aborted。
日志如下：
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2[Pipeline] timeout
3Timeout set to expire in 1 min 0 sec
4[Pipeline] {
5[Pipeline] sh
6[pipeline_basic_steps] Running shell script
7+ java -version
8openjdk version "1.8.0_181"
9OpenJDK Runtime Environment (build 1.8.0_181-b13)
10OpenJDK Server VM (build 25.181-b13, mixed mode)
11[Pipeline] sleep
12Sleeping for 1 min 1 sec
13Cancelling nested steps due to timeout
14[Pipeline] }
15[Pipeline] // timeout
16[Pipeline] }
17[Pipeline] // script
18[Pipeline] }
19[Pipeline] // stage
20[Pipeline] }
21[Pipeline] // withEnv
22[Pipeline] }
23[Pipeline] // node
24[Pipeline] End of Pipeline
25Timeout has been exceeded
26Finished: ABORTED
27
2.方法waitUntil
在waitUntil{…}里面的代码会无限制循环执行下去，直到返回true，如果返回是false,会在很短时间内再次尝试，没有尝试次数限制，如果有异常，会退出。这个我没有实际用过，不好举例。
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
2
3println env.JOB_NAME
4println env.BUILD_NUMBER
5
6pipeline{
7
8 agent any
9 stages{
10 stage("init") {
11 steps{
12 script {
13 timeout(5) {
14 waitUntil {
15 script {
16 // 监控某一个服务是否启动完成代码
17 }
18 }
19 }
20 }
21 }
22 }
23 }
24}
25
26
我没有想出一个实际例子，这里写一个伪代码。场景就是，在5分钟之内，我使用waitUntil去一直轮询检查某一个服务是否启动完成。
3.withEnv
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2
3println env.JOB_NAME
4println env.BUILD_NUMBER
5
6pipeline{
7
8 agent any
9
10 stages{
11 stage("init") {
12 steps{
13 withEnv(['java_home=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.181-3.b13.el6_10.i386/jre']) {
14 sh("$java_home/bin/java -version")
15 }
16 script {
17 println "test with withEnv feature"
18 }
19 }
20 }
21 }
22}
23
24
这个用withEnv添加多个环境变量，我没有使用过，下次如果遇到再补上。
