如何通过调优 Jenkins 队列调度优先级插件实现紧急线上热修复 Hotfix 流水线的秒级刚性插队

秒级刚性插队需Priority Sorter精准配置与资源保障协同：匹配Hotfix任务名、设Priority=0并勾选Force priority，同时确保主节点有余量、专用Agent空闲、禁用Quiet period及独占执行等配套措施。

要让紧急线上热修复（Hotfix）任务在 Jenkins 队列中实现秒级刚性插队，核心不是“加速构建”，而是**绕过排队等待、抢占执行权**。这依赖 Priority Sorter 插件的精准配置与底层调度机制的协同，而非单纯调高数值优先级。

明确插队生效的前提条件

Priority Sorter 的“插队”能力只在以下场景真实生效：

• Jenkins 主节点未满载（CPU/内存有余量），否则即使排到队首也无资源可分配；
• 目标 Hotfix 流水线已配置为使用专用 Agent 标签（如 hotfix-worker），且该标签下有空闲节点；
• 插队规则不与其他插件冲突（例如 Throttle Concurrent Builds 插件若限制了并发数，会阻断插队）；
• 触发方式为事件驱动（如 Git Webhook），避免手动点击带来的 UI 延迟。

配置 Priority Sorter 实现刚性插队

关键在于让 Hotfix 任务在进入队列瞬间就获得最高调度权重，并跳过常规排序逻辑：

• 安装插件后，在 Manage Jenkins → Configure System → Priority Sorter 中添加一条规则；
• 规则类型选 Job name pattern（非视图），填写正则表达式匹配 Hotfix 任务名，例如 ^hotfix-.*$ 或 .*-hotfix；
• 设置 Priority = 0（最小值，最高优先级），勾选 Force priority（强制应用，无视其他规则）；
• 取消勾选 Use default priority for unmatched jobs，防止非 Hotfix 任务意外继承高优；
• 保存后，Jenkins 会立即对新入队的匹配任务赋予最高调度权——只要资源就绪，它将跳过所有排队中的低优任务直接执行。

配套保障：避免插队被“软拦截”

仅靠 Priority Sorter 不足以保证秒级响应，还需消除常见阻塞点：

• 禁用队列超时退避：在 Jenkins 全局配置中关闭 Quiet period（默认5秒），Hotfix 触发后立即入队；
• 预留专用执行资源：为 hotfix-worker 节点配置 Exclusive Execution（独占执行），禁止其他任务抢占；
• 精简流水线前置阶段：Hotfix 流水线开头避免耗时操作（如 full checkout），改用 git fetch + cherry-pick 快速拉取单提交；
• 关闭构建历史归档：在 Hotfix 任务配置中取消勾选 Archive the artifacts，减少磁盘 I/O 等待。

验证插队是否真正生效

不要只看 UI 队列顺序，需确认底层行为：

• 触发 Hotfix 后，立刻查看 Build Queue 页面，确认其状态为 pending (priority: 0)；
• 打开 Script Console（https://jenkins-url/script），执行：
  println(Jenkins.instance.queue.items.find{ it.task.name == 'hotfix-prod' }?.inQueueSince) —— 若返回时间戳与触发时间差
• 观察 Agent 日志，确认 hotfix-worker 节点在入队后 Checkout 步骤。