How to continue past a failing stage in Jenkins declarative pipeline syntax How to continue past a failing stage in Jenkins declarative pipeline syntax jenkins jenkins

How to continue past a failing stage in Jenkins declarative pipeline syntax


This is now possible:

pipeline {    agent any    stages {        stage('1') {            steps {                sh 'exit 0'            }        }        stage('2') {            steps {                catchError(buildResult: 'SUCCESS', stageResult: 'FAILURE') {                    sh "exit 1"                }            }        }        stage('3') {            steps {                sh 'exit 0'            }        }    }}

In the example above, all stages will execute, the pipeline will be successful, but stage 2 will show as failed:

Pipeline Example

As you might have guessed, you can freely choose the buildResult and stageResult, in case you want it to be unstable or anything else. You can even fail the build and continue the execution of the pipeline.

Just make sure your Jenkins is up to date, since this is a fairly new feature.

EDIT: This is the question that this answer was originally written for. It is also the correct answer for a few other questions, which is why I posted this answer there as well. This is the right solution for multiple similar problems. I've tailored my other answers to their specific questions to make that clear. I only copied the answer to save myself some time. That doesn't mean it's not a good correct answer.


I may be missing something, but the idea of declarative, opinionated pipeline is to provide coverage of most simple use cases.The moment you need something the opinionated hasn't covered, you HAVE to resort to scripted pipeline, this is only referring to the "requirement" of "declarative pipeline": not going to happen now.

As to your other "requirements", they make very little sense, since the whole idea is to wrap low-level ugliness into shared libraries providing users with constructs like:

    mylib.failable_stages({      stages {        stage('stage 1') {          steps {            echo "I need to run every time"          }        }        stage('stage 2') {          steps {            echo "I need to run every time, even if stage 1 fails"          }        }        stage('stage 3') {          steps {            echo "Bonus points if the solution is robust enough to allow me to continue *or* be halted based on previous stage status"          }        }      }    })

Naturally, you would have to find or implement such mylib class and the failable_stages would get a closure, and wrap it in various plumbing/boilerplate code pieces.

Hope this is helpful.


I think it depends on how dependent the jobs are on each other. Derived from your example I would assume that

  • stage 1 is independent from all other stages, because it is the first
  • stage 2 is independent from all other stages, because stage 1 might fail immediatly and stage 2 would still be required to run
  • stage 3 depends on the result of stage 1 and stage 2

So the correpsonding pipeline could be

pipeline {    stages {        stage('Independent tasks') {            parallel {                stage('stage 1') {                    steps {                        sh 'exit 1' // failure                    }                }                stage('stage 2') {                    steps {                        echo 'Happens even so stage 1 fails'                        sh 'exit 0' // success                    }                }            }            post {  // 'stage 3'                failure {                    echo "... at least one failed"                }                success {                    echo "Success!"                }            }        }        stage ('stage 4') {            steps {                echo 'Happens only if all previous succeed'            }        }    }}

stage 1 and stage 2 will always run, stage 3 reacts on their combined success/failure.


Additional thought: This concept only works 'at the end' of your pipeline. In case you need it somewhere in the middle AND the build has to continue, you could move it into an own job and use the build job plugin.

pipeline {    stages {    stage('Start own job for stage 1, 2, 3') {        steps {            build job: 'stageOneTwoThree', propagate: false, wait: true        }    }    stage ('stage 4') {        steps {            echo 'Happens always, because "propagate: false"'        }    }}