如何通过声明式流水线修改Jenkins多分支项目的上下文消息？

在使用GitHub Organization项目的场景下，你完全不需要依赖单独的GitHub pull request builder插件，直接通过Jenkins声明式流水线结合GitHub插件就能实现自定义PR上下文消息的需求。

核心实现思路 #

利用Jenkins官方的GitHub插件（GitHub Organization项目默认已经集成该插件）提供的githubNotify流水线步骤，在流水线的不同阶段（比如构建、测试）更新PR的状态和上下文信息，就能实现你想要的自定义效果。

声明式流水线示例代码 #

下面是一个完整的示例，展示如何在构建、测试阶段分别设置自定义上下文：

pipeline {
    agent any
    stages {
        stage('代码检出') {
            steps {
                // 流水线开始时先设置一个pending状态的上下文
                githubNotify context: '流水线初始化', description: '正在检出代码🔄', status: 'PENDING'
                checkout scm
            }
        }
        stage('项目构建') {
            steps {
                sh 'mvn clean package' // 替换成你的构建命令
            }
            post {
                success {
                    githubNotify context: '项目构建', description: '构建完成✅', status: 'SUCCESS'
                }
                failure {
                    githubNotify context: '项目构建', description: '构建失败❌', status: 'FAILURE'
                }
            }
        }
        stage('自动化测试') {
            steps {
                sh 'mvn test' // 替换成你的测试命令
            }
            post {
                success {
                    githubNotify context: '自动化测试', description: '测试通过✅', status: 'SUCCESS'
                }
                failure {
                    githubNotify context: '自动化测试', description: '测试失败❌', status: 'FAILURE'
                }
            }
        }
    }
}

参数说明 #

• context：就是PR上显示的自定义上下文名称（对应你期望效果里的“项目构建”“自动化测试”这类名称）
• description：上下文的描述信息，支持添加emoji让状态更直观
• status：对应PR的状态，可选值有SUCCESS、FAILURE、PENDING、ERROR

注意事项 #

1. 确保Jenkins的GitHub插件版本足够新（建议使用最新稳定版），以支持githubNotify步骤
2. GitHub Organization项目的凭据配置要正确，需要有更新PR状态的权限
3. 如果需要更复杂的上下文控制，还可以结合setGitHubStatus步骤实现更精细的定制

这样设置后，你的PR上就会显示自定义的上下文消息，和你期望的效果一致啦！

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