如何让Jenkins定时流水线仅当全局环境变量flag为off时启动？

有两种无需额外插件的最优实现方式，比逐个给stage加when更高效：

方法1：用嵌套Stage统一控制 #

利用Jenkins声明式流水线支持的嵌套Stage特性（Jenkins 2.22+支持），把所有业务Stage包裹在一个父Stage里，只给父Stage添加判断条件，就能一次性控制所有子Stage的执行：

pipeline {
    agent any
    triggers {
        cron('H */4 * * *') // 你的定时触发规则
    }
    stages {
        stage('业务流程集合') {
            // 仅当flag为off时才执行所有子Stage
            when {
                expression { env.flag == 'off' }
            }
            stages {
                // 这里放你原来的所有业务Stage
                stage('编译构建') {
                    steps {
                        echo '执行构建操作...'
                    }
                }
                stage('自动化测试') {
                    steps {
                        echo '执行测试操作...'
                    }
                }
                stage('部署发布') {
                    steps {
                        echo '执行部署操作...'
                    }
                }
            }
        }
    }
}

当flag设为on时，整个父Stage会被标记为"跳过"，所有子Stage都不会执行，无需修改每个业务Stage的代码。

方法2：前置检查Stage直接终止流水线 #

如果希望更直观地显示流水线被终止的原因，可以在流水线最开头添加一个检查Stage，当flag为on时直接终止流水线：

pipeline {
    agent any
    triggers {
        cron('H */4 * * *')
    }
    stages {
        stage('执行权限检查') {
            steps {
                script {
                    if (env.flag == 'on') {
                        currentBuild.result = 'ABORTED'
                        error('全局flag已设为on，禁止定时触发执行')
                    }
                }
            }
        }
        // 以下是原有的业务Stage
        stage('编译构建') {
            steps {
                echo '执行构建操作...'
            }
        }
        stage('自动化测试') {
            steps {
                echo '执行测试操作...'
            }
        }
    }
}

这种方式下，当flag为on时，流水线会在检查Stage抛出错误并终止，状态标记为"ABORTED"，同时在日志里明确显示终止原因，更便于排查。

注意事项 #

• 确保全局环境变量flag已正确配置，流水线中能通过env.flag正常获取到值
• 嵌套Stage需要Jenkins版本在2.22及以上，若版本较低，优先选择方法2

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