编辑“︁Jenkins轮询SCM”︁

{{DISPLAYTITLE:Jenkins轮询SCM}}

'''Jenkins轮询SCM'''（Polling SCM）是Jenkins任务管理中一种自动触发构建的方式，通过定期检查版本控制系统（如Git、SVN等）的变更，判断是否需要执行新的构建任务。本条目将详细介绍其工作原理、配置方法、应用场景及最佳实践。

== 概述 ==
轮询SCM的核心机制是让Jenkins按预设的时间间隔（如每分钟、每小时）主动查询版本控制仓库，检测代码库是否有新的提交或变更。若检测到变更，则自动触发构建流程。这种方式避免了手动触发构建的低效，适合需要快速反馈的持续集成场景。

=== 与Webhook触发的区别 ===
* '''轮询SCM'''：由Jenkins主动发起检查，可能产生延迟（取决于轮询间隔）。
* '''Webhook触发'''：由版本控制系统推送事件通知，实时性更高但需额外配置。

== 配置方法 ==
在Jenkins任务的配置页面中，找到'''构建触发器'''（Build Triggers）部分，勾选'''轮询SCM'''（Poll SCM）选项并设置时间间隔。

=== 时间间隔语法 ===
使用类似Cron的语法定义轮询频率。例如：
<syntaxhighlight lang="bash">
# 每5分钟检查一次
H/5 * * * *
# 每小时的第15分钟检查
15 * * * *
</syntaxhighlight>

=== 示例配置 ===
以下是一个Git仓库的轮询配置示例：
<syntaxhighlight lang="groovy">
pipeline {
    agent any
    triggers {
        pollSCM('H/2 * * * *') // 每2分钟轮询一次
    }
    stages {
        stage('Build') {
            steps {
                echo '检测到变更，开始构建...'
            }
        }
    }
}
</syntaxhighlight>

== 工作原理 ==
<mermaid>
sequenceDiagram
    participant Jenkins
    participant SCM_Repository
    loop 轮询间隔
        Jenkins->>SCM_Repository: 检查变更（git log/rev-list）
        SCM_Repository-->>Jenkins: 返回最新提交哈希
        alt 有新提交
            Jenkins->>Jenkins: 触发构建
        end
    end
</mermaid>

* Jenkins通过比较本地记录的提交哈希与远程仓库的哈希值判断变更。
* 若哈希不一致，则标记为“需要构建”。

== 应用场景 ==
=== 场景1：小型团队快速迭代 ===
* 团队频繁提交代码，但未配置Webhook。
* 轮询间隔设为5-10分钟，平衡实时性与系统负载。

=== 场景2：受限环境 ===
* 防火墙限制外部Webhook访问时，轮询是唯一选择。

== 最佳实践 ==
1. '''避免高频轮询'''：过短的间隔会增加仓库服务器负载。
2. '''结合Webhook使用'''：关键分支（如main）用Webhook，其他分支用轮询。
3. '''日志监控'''：通过Jenkins日志检查轮询是否生效：
<syntaxhighlight lang="bash">
Started on Jan 01, 2024 10:00:00 AM
Polling SCM changes on master...
No changes
Done. Took 0.5 sec
</syntaxhighlight>

== 常见问题 ==
=== 轮询未触发构建 ===
* 检查语法是否正确（可通过[https://crontab.guru/ crontab.guru]验证）。
* 确认Jenkins有仓库的读取权限。

=== 性能优化 ===
对于大型仓库，可通过浅克隆（shallow clone）减少轮询时间：
<syntaxhighlight lang="groovy">
pipeline {
    agent any
    options {
        gitLabConnection('gitlab')
        disableConcurrentBuilds()
        timeout(time: 1, unit: 'HOURS')
    }
    triggers {
        pollSCM('H/30 * * * *') // 每30分钟
    }
    stages {
        stage('Checkout') {
            steps {
                git depth: 1, url: 'https://github.com/user/repo.git'
            }
        }
    }
}
</syntaxhighlight>

== 数学原理 ==
轮询间隔的合理性可通过排队论评估。假设提交事件服从泊松分布，轮询延迟期望值为：
<math>E[\text{delay}] = \frac{T}{2}</math>
其中<math>T</math>为轮询周期。例如，5分钟轮询的平均延迟为2.5分钟。

== 扩展阅读 ==
* [[Jenkins Pipeline语法]]
* [[版本控制系统集成]]

[[Category:集成部署]]
[[Category:Jenkins]]
[[Category:Jenkins任务管理]]