如何配置Jenkins声明式流水线：文件变更或新分支时执行阶段

这个问题确实很常见——新分支首次构建时，Jenkins没有历史变更记录可以对比，导致changeset条件无法匹配，进而跳过了你需要执行的容器构建阶段。

要解决这个问题，我们只需要在when的anyOf条件里新增一个判断：当前构建是该分支的首次构建。Jenkins提供了previousBuildExists()这个内置条件来帮我们做这个判断，配合not就能识别出首次构建的场景。

修改后的完整流水线代码如下：

pipeline {
    agent any
    stages {
        stage('checkout') {
            steps {
                checkout scm
            }
        }
        stage('build & push container') {
            when {
                anyOf {
                    changeset 'Dockerfile'
                    not { previousBuildExists() } // 匹配分支的首次构建
                }
            }
            steps {
                echo "Building and pushing container..."
            }
        }
    }
}

关键说明： #

• changeset 'Dockerfile'：保持原有的逻辑，只要Dockerfile有变更就触发该阶段
• not { previousBuildExists() }：当分支没有历史构建记录时（也就是首次构建），这个条件会返回true，从而触发阶段执行

这样不管是分支上修改了Dockerfile，还是刚创建的新分支首次构建，这个容器构建阶段都会正常执行了。如果你的场景还需要覆盖其他特殊情况（比如拉取请求的首次构建），可以再调整条件组合，但针对你描述的核心需求，上面的方案已经完全够用。

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