容器与云原生 / 系统课时
CronJob 定时任务
CronJob 定时任务
CronJob 用来把一段 Job 模板按时间表达式重复创建。本节会完成一个可运行的定时任务,并把并发策略、历史保留和错过调度的处理规则放进同一份清单中,最后用手动触发验证任务模板是否可靠。
学习目标
- 能编写 CronJob 的五段式调度表达式并设置明确时区
- 能根据任务特性选择并发策略、历史记录数量和错过调度期限
- 能用
kubectl验证 CronJob 配置并手动触发一次 Job
把调度规则写进 CronJob
CronJob 的 schedule 使用五段式 cron 表达式,依次表示分钟、小时、日、月、星期,不包含“秒”。下面的任务每 5 分钟调度一次,并把时区固定为 UTC,避免集群控制平面时区不同造成理解偏差。
apiVersion: batch/v1
kind: CronJob
metadata:
name: report-cleanup
spec:
schedule: "*/5 * * * *"
timeZone: "Etc/UTC"
concurrencyPolicy: Forbid
startingDeadlineSeconds: 120
successfulJobsHistoryLimit: 2
failedJobsHistoryLimit: 1
jobTemplate:
spec:
template:
spec:
restartPolicy: Never
containers:
- name: cleanup
image: busybox:1.36
command: ["/bin/sh", "-c"]
args:
- 'date -u; echo "scheduled task executed"'这份配置的生效行为是:控制器在每个匹配时间点尝试创建 Job;Job 再创建 Pod 执行命令。successfulJobsHistoryLimit 和 failedJobsHistoryLimit 只控制已结束 Job 的保留数量,不会改变未来调度。
决定重叠任务和错过调度怎么处理
concurrencyPolicy 只处理“同一个 CronJob 的前一次任务还没结束,新时间点又到了”的情况。Allow 允许重叠,Forbid 跳过本次新建,Replace 则用新任务替换仍在运行的旧任务。
startingDeadlineSeconds: 120 是错过调度的容忍窗口。控制器晚于计划时间处理时,只要延迟没有超过 120 秒,仍可补建 Job;超过期限则放弃这一轮。它适合“过时就没有价值”的周期任务,但不适合必须一轮不漏的账务或结算逻辑。

如果任务执行时间可能超过调度间隔,先确定业务是否允许并行,再选择并发策略。不要用历史保留数量代替并发控制,也不要把 startingDeadlineSeconds 当成任务超时时间;单个 Job 的运行超时应在 Job 模板中另行设计。
应用并核对关键字段
把清单保存为 cronjob.yaml 后应用,并直接读取关键字段。这样比只看 kubectl get cronjob 的表格输出更适合核对自动化配置。
kubectl apply -f cronjob.yaml
kubectl get cronjob report-cleanup -o jsonpath='{.spec.schedule}{"\n"}{.spec.concurrencyPolicy}{"\n"}{.spec.startingDeadlineSeconds}{"\n"}'预期输出如下;第一次创建资源时会出现 created,重复执行时第一行可能变为 configured。
cronjob.batch/report-cleanup created
*/5 * * * *
Forbid
120CronJob 不会因为刚创建就立即运行。为了验证 jobTemplate 本身,可以从它手动派生一个 Job,而不必等到下一个五分钟时间点。
kubectl create job --from=cronjob/report-cleanup report-cleanup-manual
kubectl wait --for=condition=complete job/report-cleanup-manual --timeout=60s
kubectl logs job/report-cleanup-manual预期输出如下;首行时间由容器的 date -u 动态产生,因此用占位符表示。
job.batch/report-cleanup-manual created
job.batch/report-cleanup-manual condition met
<TIME>
scheduled task executed根据任务语义选择参数
允许并行且每轮互不影响的采集任务可以保留 Allow;同一份数据不能同时处理时通常用 Forbid;必须始终优先执行最新一轮、旧任务可以安全中止时才考虑 Replace。历史记录保留越多,排障证据越完整,但集群中的 Job 对象也会更多。
生产环境还要确认任务是否幂等。Forbid 只能避免同一个 CronJob 主动创建重叠任务,不能替代业务幂等、外部锁或补偿机制。最终应把“什么时候执行、能否重叠、迟到多久还值得执行、保留多少运行证据”四个问题分别落到明确字段上。