如何基于所属仓库跳过Jenkins共享库中的指定流水线阶段

当前共享库把完整流水线逻辑硬编码写死在_publish方法中，没有预留配置透传口子，各仓库调用时也没有传入差异化规则，因此无法灵活完成阶段判断。可以从以下几个可落地的方案中选择适配团队协作模式的方式实现：

方案1：各仓库Jenkinsfile显式传参控制 #

改造共享库的_publish.groovy，将原来硬写的pipeline逻辑改成支持接收传入参数的动态结构，给需要灵活跳过的Unit-test阶段加上when判断条件：

// vars/_publish.groovy 改造示例
def call(Map config = [:]) {
    // 设置默认值：默认执行单元测试，只有传入明确标记时才跳过
    def skipUnitTest = config.getOrDefault('skipUnitTest', false)

    pipeline {
        environment {
            abc = credentials('abc')
            def = credentials('def')
        }
        stages {
            stage('Build') {
                steps {
                    sh 'docker build'
                }
            }
            stage('Unit-test') {
                // 增加阶段执行判断，标记为跳过值时直接不运行该阶段
                when {
                    expression { !skipUnitTest }
                }
                steps {
                    sh 'mvn test'
                }
            }
        }
    }
}

各仓库不需要升级共享库版本，只需要根据自身需求调整Jenkinsfile的调用逻辑即可：

• 需要跳过单元测试的仓库：调用时传入配置 _publish(skipUnitTest: true)
• 需要执行全流程的仓库：保持原有_publish()的调用方式即可，走默认的执行逻辑

方案2：共享库内部匹配仓库名，零修改各仓库Jenkinsfile #

如果不想逐个修改10个仓库的Jenkinsfile，可以在共享库内部自动识别当前流水线对应的Git仓库信息，直接匹配预定义的跳过名单：

// vars/_publish.groovy 内置跳过名单配置
// 把需要跳过单测的仓库名提前维护在这里
def SKIP_TEST_REPOS = ['repo-a', 'repo-b', 'repo-c']

def call() {
    // 从Jenkins内置环境变量中提取当前仓库名称，自动匹配跳过名单
    def currentRepoName = env.GIT_URL.tokenize('/')[-1].replace('.git', '')
    def needSkipTest = SKIP_TEST_REPOS.contains(currentRepoName)

    pipeline {
        environment {
            abc = credentials('abc')
            def = credentials('def')
        }
        stages {
            stage('Build') {
                steps {
                    sh 'docker build'
                }
            }
            stage('Unit-test') {
                when {
                    expression { !needSkipTest }
                }
                steps {
                    sh 'mvn test'
                }
            }
        }
    }
}

这种模式下所有仓库的现有Jenkinsfile完全不需要改动，后续要调整跳过范围，只需要修改共享库里的SKIP_TEST_REPOS名单即可，不需要逐个仓库提交PR调整配置。

方案3：基于仓库本地标记文件自动判断，减少跨团队沟通成本 #

可以在共享库中约定通用规则：如果仓库根目录下存在.jenkins/skip-unit-test标记文件，就自动跳过单元测试阶段。
Unit-test阶段的判断逻辑可以修改为：

stage('Unit-test') {
    when {
        expression {
            // 判断当前工作空间下是否存在跳过标记文件
            return !fileExists('.jenkins/skip-unit-test')
        }
    }
    steps {
        sh 'mvn test'
    }
}

这种模式的灵活性最高：仓库管理员不需要找共享库维护人员调整配置，只要在自己的仓库里新增对应路径的空文件，下次流水线运行就会自动跳过单元测试；删掉文件就恢复正常执行流程。

落地注意事项 #

• 你当前示例中的Groovy代码全部使用了中文全角引号，实际运行会直接报语法错误，需要全部替换为半角英文引号
• 所有跳过判断逻辑尽量放在when指令中实现，不要写在steps块里。这样Jenkins的可视化界面会直接把跳过的阶段置灰，不会浪费资源执行无意义的前置命令，也能让流水线执行状态更直观。

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