Jenkins自动化任务如何调度

Jenkins自动化任务调度全指南

一 常用调度方式

• 定时构建 Build periodically：在作业配置的构建触发器中使用Cron表达式按计划触发，适合夜间批处理、报表生成等固定时点任务。支持 H（Hash） 占位符用于错峰执行，降低节点瞬时压力。示例：H 2 * * *** 表示每天02:00**左右执行。
• 轮询 SCM Poll SCM：周期性检查代码仓库变更，有更新即触发构建，适合无法在代码托管侧配置 Webhook 的场景。示例：H/5 * * * *** 表示每5**分钟检查一次。
• 事件触发 Webhook：代码推送、合并请求等事件到来时由外部系统调用 Jenkins 接口触发构建，实时性强。可使用Generic Webhook Trigger等插件，或在 GitLab/GitHub 服务端/客户端钩子中调用 Jenkins 构建 URL。
• 外部脚本或系统 Cron 触发：在 Linux/CentOS 等系统用 crontab 定时调用 Jenkins 的构建 URL（配合 CSRF Crumb 更安全），适合统一在操作系统层做跨系统编排。
• Pipeline 内调度：在 Jenkinsfile 的 triggers { cron(‘…’) } 中定义计划任务，便于与代码一起版本化管理。

二 配置步骤与示例

• 定时构建（Build periodically）
  1. 进入作业 → Configure → Build Triggers → 勾选 Build periodically。
  2. 在日程表填入 Cron 表达式，建议使用 H 来分散负载，例如：
     • 每天02:00：**H 2 * * ***
     • 工作日10:00：H 10 * * 1-5
     • 每15分钟：**H/15 * * * ***
• 轮询 SCM（Poll SCM）
  • 勾选 Poll SCM，填写如 H/5 * * * *** 实现每5**分钟检查一次代码变更并触发构建。
• Webhook 触发
  • 安装并启用 Generic Webhook Trigger；在代码托管平台配置事件钩子，向 Jenkins 发送请求（按需携带参数/Header）。
  • 若开启 CSRF 保护，需先获取 Crumb：
    • 获取：crumb=$(curl -u "user:token" -s 'http://JENKINS_URL/crumbIssuer/api/xml?xpath=concat(//crumbRequestField,":",//crumb)')
    • 触发：curl -u "user:token" -H "$crumb" -X POST http://JENKINS_URL/job/your-job/build?delay=0sec
• 外部 Cron 触发
  • 在系统执行：0 2 * * * curl -u "user:token" -H "$crumb" -X POST http://JENKINS_URL/job/your-job/build?delay=0sec
• Pipeline 内调度
  • 在 Jenkinsfile：

    pipeline {
      agent any
      triggers { cron('H 10 * * 1-5') }  // 工作日 10:00
      stages { ... }
    }
    

以上配置路径与示例适用于常见 Jenkins 版本与插件组合。

三 Cron 语法与 Jenkins 特性

• 字段顺序：MINUTE HOUR DOM MONTH DOW（5 个字段）；Jenkins Cron 使用 H 做时间散列，避免大量任务在同一时刻集中执行。
• 运算符：*（任意）、M-N（范围）、*M-N/X 或 /X（步长）、A,B,C（枚举）。
• 示例速查：
  • 每15分钟：**H/15 * * * ***
  • 每天02:00：**H 2 * * ***
  • 工作日10:00：H 10 * * 1-5
  • 每周日02:00：H 2 * * 0
• 建议：在大规模实例中优先使用 H，并尽量将密集任务错开分钟位，提升调度稳定性与节点负载均衡。

四 时区与安全设置

• 时区设置
  • 若需显示与执行使用中国标准时间（Asia/Shanghai），可在 Manage Jenkins → Script Console 执行：
    • System.setProperty('org.apache.commons.jelly.tags.fmt.timeZone','Asia/Shanghai')
  • 执行后重启或重载相关组件使其生效（不同版本行为略有差异）。
• CSRF 与认证
  • 启用 CSRF Protection 时，脚本或外部系统触发构建需先获取 Crumb 并在请求头中携带；使用 API Token 替代明文密码更安全。
• 分布式执行
  • 多节点/多 Agent 场景下，结合 Label 将任务调度到合适的工作节点，提高吞吐与资源隔离。

五 实践建议

• 优先选择**事件驱动（Webhook）**获取更快反馈；对无法配置 Webhook 的仓库使用 Poll SCM 作为兜底。
• 定时任务使用 H 错峰，避免整点雪崩；将关键任务分散到不同分钟位。
• 为关键作业配置超时、重试与通知，并定期清理历史构建与工作空间，防止磁盘被占满。
• 统一凭证管理（如 API Token、SSH 密钥），并在脚本/钩子中避免明文密码。
• 将 Jenkinsfile 纳入代码仓库，配合 Pipeline 的 triggers { cron(…) } 实现“代码即调度配置”，便于审计与回滚。