GHPRB技术问题：PR更新时如何停止未使用GHPRB的下游作业？

我之前帮团队处理过几乎一模一样的场景，核心思路就是让Manager任务能管控下游作业的生命周期，或者借助Jenkins的内置能力/脚本实现精准终止。下面是几个实操性很强的方案：

方案1：用Jenkins Pipeline（最推荐） #

把你的Manager任务改成Pipeline作业（现在Jenkins官方主推，比Freestyle灵活太多），下游作业作为Pipeline的子任务来触发。这样当GHPRB终止Manager的Pipeline时，Jenkins会自动终止所有正在运行的子作业，完全不需要额外配置。

举个简单的Jenkinsfile示例：

pipeline {
    agent any
    parameters {
        string(name: 'PR_NUMBER', description: 'Pull Request Number')
    }
    stages {
        stage('Trigger Downstream Jobs') {
            steps {
                // 触发下游作业，带上PR编号参数
                build job: 'Downstream-Test-Job-1', parameters: [string(name: 'PR_NUMBER', value: "${params.PR_NUMBER}")], wait: false
                build job: 'Downstream-Test-Job-2', parameters: [string(name: 'PR_NUMBER', value: "${params.PR_NUMBER}")], wait: false
            }
        }
    }
}

当GHPRB终止这个Pipeline时，所有通过build步骤启动的下游作业都会被自动终止——因为它们是Pipeline的子进程，生命周期和父Pipeline直接绑定。

方案2：Freestyle Manager + Groovy脚本终止 #

如果暂时不想改Pipeline，也可以在你的Freestyle Manager作业里加Groovy脚本，实现记录并终止下游作业：

1. 首先，在Manager触发下游作业时，必须传递PR编号参数，同时用Parameterized Trigger Plugin的「Save build variables」功能，把下游构建号存在环境变量里（比如DOWNSTREAM_JOB1_BUILD_ID）。
2. 在Manager的Post-build Actions里添加一个「Execute system Groovy script」步骤，脚本逻辑如下：

// 获取当前Manager的PR编号
def prNumber = build.buildVariables.get('PR_NUMBER')

// 遍历需要终止的下游作业
def downstreamJobs = ['Downstream-Test-Job-1', 'Downstream-Test-Job-2']
downstreamJobs.each { jobName ->
    def job = Jenkins.instance.getItemByFullName(jobName)
    // 找到该作业中，PR编号匹配且正在运行的构建
    job.builds.each { build ->
        if (build.isBuilding() && build.buildVariables.get('PR_NUMBER') == prNumber) {
            println "Stopping build ${build.number} of job ${jobName} for PR ${prNumber}"
            build.stop()
        }
    }
}

⚠️ 注意：需要在Jenkins全局安全配置里，给执行这个脚本的用户授予「Run scripts」权限，或者用Script Security Plugin来允许相关方法调用。

方案3：下游作业加终止触发逻辑 #

给每个下游作业添加一个特殊参数（比如STOP_PR_BUILD），当Manager收到GHPRB的停止信号时，触发下游作业的一个特殊构建，传入PR编号和STOP_PR_BUILD=true：

1. 下游作业里添加一个「Execute Groovy script」的构建步骤，放在最前面：

def prNumber = build.buildVariables.get('PR_NUMBER')
def stopBuild = build.buildVariables.get('STOP_PR_BUILD') == 'true'

if (stopBuild) {
    // 找到当前作业中同PR号的运行中构建并停止
    def currentJob = Jenkins.instance.getItemByFullName(env.JOB_NAME)
    currentJob.builds.each { build ->
        if (build.isBuilding() && build.buildVariables.get('PR_NUMBER') == prNumber && build.number != currentBuild.number) {
            println "Stopping duplicate build ${build.number} for PR ${prNumber}"
            build.stop()
        }
    }
    // 终止当前的“停止触发”构建
    currentBuild.stop()
}

2. 在Manager的「Post-build Actions」里，利用GHPRB的「Cancel older builds」触发钩子，触发下游作业的这个终止构建。

这个方案适合下游作业无法和Manager直接绑定的场景，但配置相对繁琐一些。

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