Jenkins构建失败/超时后如何跳过阶段直接执行Destroy阶段？

问题描述 #

需要实现：当Jenkins构建过程中出现失败或超时时，跳过所有中间阶段，直接执行Destroy清理阶段。此前尝试两种方案均未成功：

尝试方案1：为Build阶段添加timeout配置 #

此方案中，Build阶段超时后整个构建会被直接中止，无法执行后续的Destroy操作：

stage('Build') {
    options {                                                                                                                                                                   
        timeout(time: 10, unit: 'MINUTES')
    }
    steps {
        // Build steps
    }
}
// Other stages

尝试方案2：在Post块中判断结果触发Destroy阶段 #

此方案中，Post块内的stage调用未生效，无法触发Destroy阶段执行：

pipeline {
agent any
stages {
    stage('Stage 1') {
        steps {
            // Add your stage 1 steps here
        }
    }
    stage('Stage 2') {
        steps {
            // Add your stage 2 steps here
        }
    }
    // Repeat for stages 3 to 8
    stage('Last Stage') {
        steps {
            // Add your last stage steps here
        }
    }
}
post {
    always {
        script {
            if (currentBuild.result == 'FAILURE') {
                stage('Last Stage') {
                    // Add your last stage steps here
                }
            }
        }
    }
}

解决方案 #

方法1：使用catchError捕获异常+when条件控制阶段执行 #

这种方案能保留Pipeline的可视化流程，同时确保失败/超时后跳过中间阶段、执行Destroy：

pipeline {
    agent any
    stages {
        stage('Build') {
            options {
                timeout(time: 10, unit: 'MINUTES')
            }
            steps {
                // 捕获Build阶段的失败/超时，标记构建结果为FAILURE但不中止Pipeline
                catchError(buildResult: 'FAILURE', stageResult: 'FAILURE') {
                    sh 'echo "执行Build操作"'
                    // 这里替换为实际的Build步骤
                }
            }
        }
        stage('Test') {
            // 仅当构建未失败时才执行此阶段
            when {
                not {
                    equals expected: 'FAILURE', actual: currentBuild.result
                }
            }
            steps {
                sh 'echo "执行Test操作"'
                // 替换为实际的Test步骤
            }
        }
        // 其他中间阶段（如Package、Deploy等）都添加上述when条件，实现失败时跳过
        stage('Destroy') {
            // 无论构建结果如何，始终执行此阶段
            when { always() }
            steps {
                sh 'echo "执行Destroy清理操作"'
                // 替换为实际的销毁步骤
            }
        }
    }
}

原理说明：

• catchError：捕获Build阶段的超时、失败等异常，将构建结果标记为FAILURE，但不会终止整个Pipeline，让流程能继续走到Destroy阶段。
• when条件：中间阶段通过判断currentBuild.result是否为FAILURE，决定是否跳过；Destroy阶段用always()确保必执行。

方法2：全局超时+Post块执行Destroy #

如果需要全局控制整个Pipeline的超时时间，可使用全局timeout配置，结合Post块的always执行Destroy：

pipeline {
    agent any
    options {
        // 全局超时，覆盖所有阶段的总耗时
        timeout(time: 30, unit: 'MINUTES')
    }
    stages {
        stage('Build') {
            steps {
                sh 'echo "执行Build操作"'
            }
        }
        stage('Test') {
            steps {
                sh 'echo "执行Test操作"'
            }
        }
        // 其他中间阶段
    }
    post {
        always {
            // 无论构建成功、失败、超时，都会执行此处的Destroy逻辑
            sh 'echo "执行Destroy清理操作"'
        }
    }
}

注意事项：

• 全局超时触发时，Jenkins会将构建标记为ABORTED，但仍会进入always块执行Destroy。
• Post块内的操作不会在Pipeline的阶段视图中显示，适合简单的清理逻辑；如果需要可视化Destroy阶段，推荐使用方法1。

原方案问题分析 #

• 方案1：默认的timeout会直接中止整个Pipeline，导致后续阶段（包括Destroy）完全无法执行，必须配合catchError捕获异常才能继续流程。
• 方案2：Post块中嵌套stage的写法不会在Pipeline可视化界面中展示，且重复编写Destroy代码维护性差；同时currentBuild.result在Post块中可能未完成更新，判断逻辑不可靠。

内容的提问来源于stack exchange，提问作者ADITYA GUPTA