Jenkins与Linux定时任务的结合使用
一、推荐方式 在Jenkins内使用Build periodically
- 进入任务的配置 → 构建触发器，勾选Build periodically。在日程表中输入类似cron的五字段表达式：MINUTE HOUR DOM MONTH DOW（取值范围：分钟0–59、小时0–23、日期1–31、月份1–12、星期0–7，0和7均为周日）。Jenkins还支持简写别名如**@daily、@hourly等，并可使用H（hash）做时间散列以避免多个任务同时启动（例如：H H * * ）。需要时也可在字段中使用英文星期缩写（如Mon–Fri）。示例：每周一到周五08:30执行可写为30 8 * * 1-5或30 8 * * Mon-Fri*。
二、备选方式 用Linux的cron触发Jenkins构建
- 当希望由操作系统层面驱动构建，或Jenkins节点不可直接访问时，可在Linux上用cron定时调用Jenkins的HTTP接口触发构建。编辑当前用户的crontab：执行crontab -e，按需添加条目。示例（每天09:00触发某任务）：0 9 * * * /usr/bin/curl -X POST http://your_jenkins_server/job/your_job_name/build（如使用API Token，可在URL或Header中携带凭据）。注意确保运行cron的用户环境与网络可达性、权限配置正确。
三、两种方式的选择与对比
| 维度 |
在Jenkins内定时 |
用Linux cron触发 |
| 调度主体 |
Jenkins Master/节点 |
操作系统 cron |
| 表达式 |
五字段，支持H与**@别名** |
五字段，标准cron语法 |
| 触发对象 |
直接触发Job |
通过HTTP请求触发Job |
| 适用场景 |
常规构建、流水线、需要Jenkins内部上下文 |
跨网络触发、外部系统集成、统一运维编排 |
| 优点 |
与Jenkins生态深度集成、可视化与日志统一 |
简单直接、与系统级任务统一治理 |
| 注意点 |
合理用H避免“零点尖峰”；注意时区 |
处理好认证、CSRF、网络与代理配置 |
四、常见写法示例
- 在Jenkins内（Build periodically）
- 每天03:00执行：*H 3 * * （使用H分散负载）
- 工作日09:00执行：30 8 * * 1-5 或 30 8 * * Mon-Fri
- 每周六02:00执行：0 2 * * 6
- 每天18:00–23:00每30分钟：***/30 18-23 * * ***
- 用Linux cron触发（HTTP）
- 每天09:00触发：0 9 * * * /usr/bin/curl -X POST http://jenkins.example.com/job/example/build
- 每5分钟触发：*/5 * * * * /usr/bin/curl -X POST http://jenkins.example.com/job/example/build
- 建议将输出重定向到日志以便排查：例如**>> /var/log/jenkins_cron.log 2>&1**。
五、排错与最佳实践
- 时间与时区
- Jenkins界面时间与系统可能不一致，必要时在Jenkins全局配置设置时区，或使用TZ=Asia/Shanghai前缀（如：TZ=Asia/Shanghai H 2 * * 6）。
- 负载均衡
- 多个日常任务避免集中在同一时刻，尽量使用H（如：*H H * * ），让执行时间在各任务间均匀散列。
- 认证与安全
- 使用API Token进行触发，避免在命令行中明文写密码；必要时配置CSRF豁免或使用crumb机制。
- 日志与监控
- 为cron任务增加日志输出与错误重定向，并定期审计**/var/log/cron**或系统日志，确认任务是否按时执行。
