如何为Jenkins流水线的Stage添加新状态？求可行方案

阿华AIGC实验室

2026-5-19

在Jenkins流水线中为Stage添加自定义状态的可行方案

嘿，这个需求完全可以实现！我之前帮不少开发者解决过类似的问题，主要有两种实用思路，适配不同的Pipeline类型，下面给你详细拆解：

方法1：通过Pipeline脚本直接自定义状态（无需额外插件）

这种方法适合不想安装插件的场景，利用Jenkins内置的currentBuild对象来添加自定义状态标记，既能在构建详情页显示，也能在Stage视图里体现。

Declarative Pipeline 示例

pipeline {
    agent any
    stages {
        stage('代码构建') {
            steps {
                script {
                    // 模拟业务逻辑判断，确定自定义状态
                    def buildStatus = "构建完成待审核"
                    // 给构建添加显示名称，带上自定义状态
                    currentBuild.displayName = "${currentBuild.displayName} [${buildStatus}]"
                    // 添加醒目的短文本标记，在构建列表里一眼就能看到
                    currentBuild.addShortText(buildStatus, "blue", "white", "1px", "black")
                    // 也可以给Stage添加描述
                    currentBuild.description = "Stage状态：${buildStatus}"
                }
                // 执行实际的构建步骤
                sh "mvn clean package -DskipTests"
            }
            post {
                always {
                    // 可以在post块里根据执行结果动态更新状态
                    if (currentBuild.result == "SUCCESS") {
                        currentBuild.description = "Stage状态：构建成功"
                    } else {
                        currentBuild.description = "Stage状态：构建失败"
                    }
                }
            }
        }
    }
}

Scripted Pipeline 示例

node {
    stage('应用部署') {
        try {
            echo "开始部署到测试环境..."
            sh "kubectl apply -f test-deployment.yaml"
            // 设置成功状态
            currentBuild.displayName = "部署 [完成]"
            currentBuild.addShortText("部署成功", "green", "white", "1px", "black")
        } catch (Exception e) {
            // 设置失败后的自定义状态
            currentBuild.displayName = "部署 [需回滚]"
            currentBuild.addShortText("部署失败", "red", "white", "1px", "black")
            throw e // 保留原有异常，不影响流水线的核心状态判断
        }
    }
}

方法2：使用专用插件增强自定义状态显示

如果想要更专业的Stage状态管理（比如在Blue Ocean视图里直接替换默认状态标签），可以安装Custom Stage Status Plugin，它支持直接在Pipeline中设置Stage的自定义状态和颜色。

插件使用示例

pipeline {
    agent any
    stages {
        stage('自动化测试') {
            steps {
                script {
                    // 设置执行中的自定义状态
                    setStageStatus("测试执行中", "YELLOW")
                    // 执行测试步骤
                    sh "mvn test"
                    // 根据测试结果更新状态
                    if (currentBuild.result == "SUCCESS") {
                        setStageStatus("测试通过", "GREEN")
                    } else {
                        setStageStatus("测试存在缺陷", "RED")
                    }
                }
            }
        }
    }
}