3. Jenkins 事件机制：Webhook、Poll SCM、定时触发、上游任务触发

Jenkins 管道的启动并非总是手动点击“立即构建”。在自动化测试体系中，管道需要对外部事件做出实时响应。Jenkins 提供了四种核心事件触发机制：Webhook（外部推送）、Poll SCM（轮询拉取）、定时触发（时间驱动）和上游任务触发（管道依赖）。理解每种机制的适用场景与配置方式，是构建可靠 Runbook 联动的基础。

3.1 四种触发机制对比

3.2 Webhook 触发：事件驱动的核心

Webhook 是 Jenkins 接收外部事件的标准方式。当代码仓库（GitHub、GitLab、Bitbucket）发生 push、merge、tag 等事件时，仓库主动向 Jenkins 的 Webhook 端点发送 HTTP POST 请求，Jenkins 解析请求体后触发对应的管道。

配置要点

• Jenkins 端：安装对应仓库的插件（如 GitHub Integration Plugin、GitLab Plugin），在 Job 配置中勾选 “GitHub hook trigger for GITScm polling” 或 “Build when a change is pushed to GitLab”。
• 仓库端：在仓库设置中添加 Webhook，URL 格式为 http://<jenkins-url>/github-webhook/（GitHub）或 http://<jenkins-url>/project/<job-name>（GitLab）。
• 安全：建议配置 Secret 进行请求验证，防止恶意触发。

// Jenkinsfile 中声明式 Webhook 触发示例（GitHub）
pipeline {
    agent any
    triggers {
        // 监听 GitHub push 事件
        githubPush()
    }
    stages {
        stage('Runbook 联动测试') {
            steps {
                echo "触发来源: ${env.CHANGE_ID ? 'PR #' + env.CHANGE_ID : 'Branch Push'}"
                // 调用 Runbook 执行自动化测试
                sh 'runbook-execute --suite smoke-test'
            }
        }
    }
}

3.3 Poll SCM 触发：轮询拉取变更

Poll SCM 是 Jenkins 主动定期检查源代码仓库是否有变更的机制。如果检测到新的提交，则触发一次构建。该方式不依赖外部推送，适合仓库无法配置 Webhook 或网络隔离的场景。

配置方式

在 Job 配置的 “Build Triggers” 中勾选 “Poll SCM”，并在日程表中填写 Cron 表达式。例如：

H/5 * * * *   // 每 5 分钟检查一次仓库变更

3.4 定时触发：基于 Cron 的周期执行

定时触发与 Poll SCM 不同，它不检查代码变更，而是严格按照时间计划执行管道。适用于不需要代码变更驱动的定期任务，如：

• 每日凌晨 2:00 执行全量回归测试
• 每周一上午 9:00 执行安全扫描
• 每月 1 号执行性能基线测试

// Jenkinsfile 中声明式定时触发
pipeline {
    agent any
    triggers {
        // 每天凌晨 2:00 触发
        cron('0 2 * * *')
    }
    stages {
        stage('Nightly Regression') {
            steps {
                echo "执行夜间回归测试..."
                sh 'runbook-execute --suite full-regression'
            }
        }
    }
}

3.5 上游任务触发：管道依赖链

上游任务触发允许一个 Job 在另一个 Job 成功（或稳定）完成后自动启动。这是构建 CI/CD 管道依赖链的核心机制，常用于：

• 部署 Job 完成后触发自动化测试 Job
• 编译 Job 完成后触发单元测试 Job
• 集成测试 Job 完成后触发端到端测试 Job

配置方式

在 Job 配置的 “Build Triggers” 中勾选 “Build after other projects are built”，填写上游 Job 名称，并选择触发条件（如 “Trigger only if build is stable”）。

// Jenkinsfile 中声明式上游触发
pipeline {
    agent any
    triggers {
        // 监听上游 Job "deploy-service" 的稳定构建
        upstream(upstreamProjects: 'deploy-service', threshold: hudson.model.Result.SUCCESS)
    }
    stages {
        stage('Post-Deploy Test') {
            steps {
                echo "上游部署完成，启动自动化测试..."
                sh 'runbook-execute --suite post-deploy'
            }
        }
    }
}

3.6 四种触发机制协同架构

在实际的 Runbook 联动自动化测试体系中，四种触发机制往往组合使用。下图展示了它们如何协同工作：

3.7 组合触发策略与最佳实践

在 Runbook 联动自动化测试中，单一触发方式往往无法满足所有需求。推荐采用以下组合策略：

3.8 实战：配置一个多触发管道

以下 Jenkinsfile 演示了如何在一个管道中同时配置 Webhook、定时触发和上游触发：

pipeline {
    agent any

    triggers {
        // 1. Webhook 触发：监听 GitHub push 事件
        githubPush()

        // 2. 定时触发：每天凌晨 3:00 执行
        cron('0 3 * * *')

        // 3. 上游触发：等待 "deploy-prod" Job 成功后执行
        upstream(upstreamProjects: 'deploy-prod', threshold: hudson.model.Result.SUCCESS)
    }

    stages {
        stage('Determine Trigger Source') {
            steps {
                script {
                    // 通过环境变量判断触发来源
                    if (env.BUILD_CAUSE == 'SCMTrigger') {
                        echo "触发来源: Poll SCM 或 Webhook"
                    } else if (env.BUILD_CAUSE == 'TimerTrigger') {
                        echo "触发来源: 定时任务"
                    } else if (env.BUILD_CAUSE == 'UpstreamCause') {
                        echo "触发来源: 上游 Job ${env.CAUSE_UPSTREAM_PROJECT}"
                    } else {
                        echo "触发来源: 手动构建"
                    }
                }
            }
        }
        stage('Runbook 联动测试') {
            steps {
                // 根据触发来源选择测试套件
                script {
                    def suite = 'smoke-test'
                    if (env.BUILD_CAUSE == 'TimerTrigger') {
                        suite = 'full-regression'
                    } else if (env.BUILD_CAUSE == 'UpstreamCause') {
                        suite = 'post-deploy'
                    }
                    sh "runbook-execute --suite ${suite}"
                }
            }
        }
    }
}