如果阶段设置构建失败/不稳定状态，如何退出Jenkins管道？

Question

我有一个带有stage1、stage2、stage3等的声明性Jenkins管道。如果stage1设置生成不稳定/失败，我想停止运行stage2。

我知道，当构建未成功时，我可以使用return停止运行stage1中的步骤，但无法找到一种方法，在不运行以下阶段的情况下退出管道stage1

以下是我所拥有的：

    stage('stage1') {
            steps {
                script{
                    //somesteps
                    if ("${stdout}" == "1"){
                    currentBuild.result = 'UNSTABLE'
                    return
                    } //if
                    //somesteps
            } //script
        } //steps
    } //stage

    // run only when stage1 is success
    stage('stage2'){
        when {
            expression { 
             params.name ==~ /x|y/
            }
        }
        steps {
            script{
                    //stage2 steps
            }
        }
    }

如果params.name==~ /z/阶段3将执行跳过阶段2

注意：我不能包括阶段2/3/...阶段1中的步骤。应该是那样的。基于构建参数第2/3/4阶段...将在第1阶段之后调用

Answer 1

您也可以简单地抛出一个异常。这将中止构建。事实上，在catch子句中简单地设置构建状态非常有效。然后，您还可以在finally块中添加自定义逻辑，用于发送生成状态更改通知（电子邮件、松弛消息等）

因此，可能类似于以下内容。注意：我已经从现有的Jenkins文件中复制了一些。因此，不能100%确定这与您使用的语法相同：

pipeline {
   try {
      stages {
         stage("stage1") {
             if (something) {
               throw new RuntimeException("Something went wrong")
             }
         }

         stage("stage2") {

         }

      } 
  } catch (e) {
     currentBuild.result = "FAILED"
     throw e
  } 
}

Answer 2

您可以在阶段中使用post退出，如下所示：

pipeline {
    stages {
        stage('stage 1') {
            steps {
                 //step 1
            }
        }
        stage('stage 2') {
            steps {
                script{ 
                    //step 2
                }
            }
            post{
                success {
                }
                failure {
                    script{
                        sh "exit 1"
                        //or
                        error "Failed, exiting now..."
                    }
                }
                aborted {
                }
                unstable {
                    script{
                           sh "exit 1"
                          //or
                          error "Unstable, exiting now..."                    
                     }
                }
            }
        }
    }
}

这将中止生成，作业将无法进一步运行。

Answer 3

跳过其余管道阶段的最简单方法是设置一个变量，该变量将控制是否应跳过以下阶段。大概是这样的：

def skipRemainingStages = false

pipeline {
    agent any

    stages {
        stage("Stage 1") {
            steps {
                script {
                    skipRemainingStages = true

                    println "skipRemainingStages = ${skipRemainingStages}"
                }
            }
        }

        stage("Stage 2") {
            when {
                expression {
                    !skipRemainingStages
                }
            }

            steps {
                script {
                    println "This text wont show up...."
                }
            }
        }

        stage("Stage 3") {
            when {
                expression {
                    !skipRemainingStages
                }
            }

            steps {
                script {
                    println "This text wont show up...."
                }
            }
        }
    }
}

这是一个非常简单的示例，在阶段1和阶段2和阶段3将skipreminingstages设置为true，因为when块中的表达式计算结果不为true。

或者，您可以调用错误（字符串消息）步骤停止管道并将其状态设置为失败。例如，如果阶段1调用error（msg）步骤如下：

stage("Stage 1") {
    steps {
        script {
            error "This pipeline stops here!"
        }
    }
}

在这种情况下，只要找到error（msg）步骤，管道就会停止，并且忽略所有剩余的阶段（时，甚至不检查块）。

当然，您可以根据某些条件调用error（msg），只有在满足特定条件时才能使其失败。