容器与云原生 / 系统课时

CronJob 定时任务

CronJob 定时任务

CronJob 用来把一段 Job 模板按时间表达式重复创建。本节会完成一个可运行的定时任务,并把并发策略、历史保留和错过调度的处理规则放进同一份清单中,最后用手动触发验证任务模板是否可靠。

学习目标

  • 能编写 CronJob 的五段式调度表达式并设置明确时区
  • 能根据任务特性选择并发策略、历史记录数量和错过调度期限
  • 能用 kubectl 验证 CronJob 配置并手动触发一次 Job

把调度规则写进 CronJob

CronJob 的 schedule 使用五段式 cron 表达式,依次表示分钟、小时、日、月、星期,不包含“秒”。下面的任务每 5 分钟调度一次,并把时区固定为 UTC,避免集群控制平面时区不同造成理解偏差。

yaml
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;超过期限则放弃这一轮。它适合“过时就没有价值”的周期任务,但不适合必须一轮不漏的账务或结算逻辑。

CronJob 从调度到任务执行的控制链路

如果任务执行时间可能超过调度间隔,先确定业务是否允许并行,再选择并发策略。不要用历史保留数量代替并发控制,也不要把 startingDeadlineSeconds 当成任务超时时间;单个 Job 的运行超时应在 Job 模板中另行设计。

应用并核对关键字段

把清单保存为 cronjob.yaml 后应用,并直接读取关键字段。这样比只看 kubectl get cronjob 的表格输出更适合核对自动化配置。

bash
kubectl apply -f cronjob.yaml
kubectl get cronjob report-cleanup -o jsonpath='{.spec.schedule}{"\n"}{.spec.concurrencyPolicy}{"\n"}{.spec.startingDeadlineSeconds}{"\n"}'

预期输出如下;第一次创建资源时会出现 created,重复执行时第一行可能变为 configured。

text
cronjob.batch/report-cleanup created
*/5 * * * *
Forbid
120

CronJob 不会因为刚创建就立即运行。为了验证 jobTemplate 本身,可以从它手动派生一个 Job,而不必等到下一个五分钟时间点。

bash
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 动态产生,因此用占位符表示。

text
job.batch/report-cleanup-manual created
job.batch/report-cleanup-manual condition met
<TIME>
scheduled task executed

根据任务语义选择参数

允许并行且每轮互不影响的采集任务可以保留 Allow;同一份数据不能同时处理时通常用 Forbid;必须始终优先执行最新一轮、旧任务可以安全中止时才考虑 Replace。历史记录保留越多,排障证据越完整,但集群中的 Job 对象也会更多。

生产环境还要确认任务是否幂等。Forbid 只能避免同一个 CronJob 主动创建重叠任务,不能替代业务幂等、外部锁或补偿机制。最终应把“什么时候执行、能否重叠、迟到多久还值得执行、保留多少运行证据”四个问题分别落到明确字段上。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

CronJob 定时任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通