容器与云原生 / 系统课时
Job 与 CronJob
Job 与 CronJob
Job 负责把一次性任务可靠地运行到完成,CronJob 则按时间计划创建 Job。本课将分别部署两种资源,验证完成状态与日志,并配置重试、并发、时区和历史清理策略。
学习目标
- 区分 Job、CronJob 与长期运行工作负载的控制目标
- 编写并验证一次性 Job 和周期性 CronJob
- 配置重试、并发限制、时区与完成记录清理
运行模型与一次性 Job
Job 创建一个或多个 Pod,并持续重试,直到达到所需成功次数或进入失败状态;CronJob 本身不直接运行容器,而是在计划时间创建 Job,再由 Job 管理 Pod。:contentReference[oaicite:4]{index=4}

长期服务通常期望容器持续运行,而批处理任务应有明确终点,并让进程以退出码 0 表示成功、非零表示失败。任务可能被重试,因此写入数据库、上传文件或发送消息时要尽量设计成幂等操作。
下面的 Job 生成一条报告日志,失败时最多重试两次,运行超过 60 秒则终止,完成 300 秒后允许 TTL 控制器清理资源。
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,再创建资源、等待完成并读取日志。
kubectl apply -f job-report-once.yaml
kubectl wait --for=condition=complete job/report-once --timeout=90s
kubectl logs job/report-once预期输出如下,时间值会不同。
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 秒便跳过,并限制成功与失败历史数量。
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 来验证容器逻辑。
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> 为动态值。
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 表达式、时区、暂停状态、并发策略和启动截止时间。