容器与云原生 / 系统课时

Job 与 CronJob

Job 与 CronJob

Job 负责把一次性任务可靠地运行到完成,CronJob 则按时间计划创建 Job。本课将分别部署两种资源,验证完成状态与日志,并配置重试、并发、时区和历史清理策略。

学习目标

  • 区分 Job、CronJob 与长期运行工作负载的控制目标
  • 编写并验证一次性 Job 和周期性 CronJob
  • 配置重试、并发限制、时区与完成记录清理

运行模型与一次性 Job

Job 创建一个或多个 Pod,并持续重试,直到达到所需成功次数或进入失败状态;CronJob 本身不直接运行容器,而是在计划时间创建 Job,再由 Job 管理 Pod。:contentReference[oaicite:4]{index=4}

Job 与 CronJob 的创建链路和状态流

长期服务通常期望容器持续运行,而批处理任务应有明确终点,并让进程以退出码 0 表示成功、非零表示失败。任务可能被重试,因此写入数据库、上传文件或发送消息时要尽量设计成幂等操作。

下面的 Job 生成一条报告日志,失败时最多重试两次,运行超过 60 秒则终止,完成 300 秒后允许 TTL 控制器清理资源。

yaml
apiVersion: batch/v1
kind: Job
metadata:
  name: report-once
spec:
  backoffLimit: 2
  activeDeadlineSeconds: 60
  ttlSecondsAfterFinished: 300
  template:
    spec:
      restartPolicy: Never
      containers:
        - name: report
          image: busybox:1.36.1
          command: ["/bin/sh", "-c"]
          args:
            - |
              echo "report generated at $(date -u +%FT%TZ)"

保存为 job-report-once.yaml,再创建资源、等待完成并读取日志。

bash
kubectl apply -f job-report-once.yaml
kubectl wait --for=condition=complete job/report-once --timeout=90s
kubectl logs job/report-once

预期输出如下,时间值会不同。

text
job.batch/report-once created
job.batch/report-once condition met
report generated at <TIME>

Job 达到指定成功次数后不再创建 Pod,但完成的 Job 和 Pod 默认会保留以便检查状态与日志;ttlSecondsAfterFinished 可在完成后自动级联清理。activeDeadlineSeconds 达到上限时会终止运行中的 Pod,并优先于 backoffLimit 生效。:contentReference[oaicite:5]{index=5}

将任务改为 CronJob

下面的 CronJob 每 5 分钟按 UTC 运行一次。同一时刻只允许一个任务运行,错过计划超过 120 秒便跳过,并限制成功与失败历史数量。

yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: report-every-five-minutes
spec:
  schedule: "*/5 * * * *"
  timeZone: "Etc/UTC"
  concurrencyPolicy: Forbid
  startingDeadlineSeconds: 120
  successfulJobsHistoryLimit: 2
  failedJobsHistoryLimit: 1
  jobTemplate:
    spec:
      backoffLimit: 2
      template:
        spec:
          restartPolicy: Never
          containers:
            - name: report
              image: busybox:1.36.1
              command: ["/bin/sh", "-c"]
              args:
                - |
                  echo "scheduled report at $(date -u +%FT%TZ)"

保存为 cronjob-report.yaml。不必等待下一个五分钟边界,可从 CronJob 模板手动创建一次 Job 来验证容器逻辑。

bash
kubectl apply -f cronjob-report.yaml
RUN_ID=$(date +%s)
kubectl create job --from=cronjob/report-every-five-minutes "report-manual-${RUN_ID}"
kubectl wait --for=condition=complete "job/report-manual-${RUN_ID}" --timeout=90s
kubectl logs "job/report-manual-${RUN_ID}"

预期输出如下,<ID> 与 <TIME> 为动态值。

text
cronjob.batch/report-every-five-minutes created
job.batch/report-manual-<ID> created
job.batch/report-manual-<ID> condition met
scheduled report at <TIME>

Cron 表达式依次表示分钟、小时、日、月、星期;timeZone 应使用独立字段,不要把 TZ 或 CRON_TZ 写进 schedule。CronJob 的调度不是绝对精确一次,极端情况下可能多建或漏建 Job,因此任务仍应具备幂等性。:contentReference[oaicite:6]{index=6}

关键参数与可靠性边界

completions 表示需要累计多少次成功,parallelism 限制并行 Pod 数;不设置时,普通 Job 通常按一次成功完成。backoffLimit 控制失败重试上限,activeDeadlineSeconds 控制整体运行时长。

CronJob 的 concurrencyPolicy 可取 Allow、Forbid 或 Replace,只约束同一个 CronJob 创建的 Job。Forbid 适合备份、结算等不可重叠任务;Replace 适合只关心最新一轮结果的任务。历史限制用于控制对象数量,不等同于业务数据保留策略。:contentReference[oaicite:7]{index=7}

排查时先查看 kubectl get jobs 与 kubectl get pods,再用 kubectl describe cronjob report-every-five-minutes 检查最近计划时间、活动 Job 和事件。若没有新 Job,重点核对 Cron 表达式、时区、暂停状态、并发策略和启动截止时间。

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

目录与阅读设置

阅读设置

17

记录一个想法

Job 与 CronJob

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

登录哪都通