CronJob
Linux 中有 cron 程序定时执行任务,Kubernetes 的 CronJob 提供了类似的功能,可以定时执行 Job。CronJob 配置文件示例如下:
- spec.template格式同Pod
- RestartPolicy仅支持Never或OnFailure
- 单个Pod时,默认Pod成功运行后Job即结束
- spec.completions标志Job结束需要成功运行的Pod个数,默认为1
- spec.parallelism标志并行运行的Pod的个数,默认为1
- spec.activeDeadlineSeconds标志失败Pod的重试最大时间,超过这个时间不会继续重试
CronJob
Cron Job管理基于时间的 Job,即:
- 在给定时间点只运行一次
- 周期性地在给定时间点运行
使用条件:当前使用的 Kubernetes 集群,版本 >= 1.8(对 CronJob)
典型的用法如下所示:
- 在给定的时间点调度 Job 运行
- 创建周期性运行的 Job,例如:数据库备份、发送邮件
Cron Job Spec
- spec.schedule:调度,必需字段,指定任务运行周期,格式同 Cron
- spec.jobTemplate:Job 模板,必需字段,指定需要运行的任务,格式同 Job
- spec.startingDeadlineSeconds:启动 Job 的期限(秒级别),该字段是可选的。如果因为任何原因而错过了被调度的时间,那么错过执行时间的 Job 将被认为是失败的。如果没有指定,则没有期限
- spec.concurrencyPolicy:并发策略,该字段也是可选的。它指定了如何处理被 Cron Job 创建的 Job 的并发执行。只允许指定下面策略中的一种:
- Allow(默认):允许并发运行
- JobForbid:禁止并发运行,如果前一个还没有完成,则直接跳过下一个
- Replace:取消当前正在运行的 Job,用一个新的来替换注意,当前策略只能应用于同一个 Cron Job 创建的 Job。如果存在多个 Cron Job,它们创建的 Job 之间总是允许并发运行。
- spec.suspend:挂起,该字段也是可选的。如果设置为true,后续所有执行都会被挂起。它对已经开始执行的 Job 不起作用。默认值为false。
- spec.successfulJobsHistoryLimit和spec.failedJobsHistoryLimit:历史限制,是可选的字段。它们指定了可以保留多少完成和失败的 Job。默认情况下,它们分别设置为3和1。设置限制的值为0,相关类型的 Job 完成后将不会被保留
[root@k8s-master ~]# cat cronjob.yml
apiVersion: batch/v1beta1
kind: CronJob
metadata:
name: hello
spec:
schedule: "*/1 * * * *"
jobTemplate:
spec:
template:
spec:
containers:
- name: hello
image: busybox
command: ["echo","hellow k8s job!"]
restartPolicy: OnFailure
-
schedule
指定什么时候运行 Job,其格式与 Linux cron 一致。这里*/1 * * * *
的含义是每一分钟启动一次。 jobTemplate
定义 Job 的模板,格式与前面 Job 一致。
通过 kubectl get cronjob
查看 CronJob 的状态:
[root@k8s-master ~]# kubectl get cronjob
NAME SCHEDULE SUSPEND ACTIVE LAST SCHEDULE AGE
hello */1 * * * * False 0 62s 6m25s
等待几分钟,然后通过 kubectl get jobs
查看 Job 的执行情况:
[root@k8s-master ~]# kubectl get jobs
NAME COMPLETIONS DURATION AGE
hello-1604905740 1/1 23s 3m12s
hello-1604905800 1/1 18s 2m11s
hello-1604905860 1/1 19s 70s
hello-1604905920 0/1 9s 9s
可以看到每隔一分钟就会启动一个 Job。执行 kubectl logs
可查看某个 Job 的运行日志:
[root@k8s-master ~]# kubectl get pod
NAME READY STATUS RESTARTS AGE
hello-1604905860-chlxz 0/1 Completed 0 2m25s
hello-1604905920-9w96k 0/1 Completed 0 85s
hello-1604905980-cqgd2 0/1 Completed 0 34s
[root@k8s-master ~]# kubectl get pod
NAME READY STATUS RESTARTS AGE
hello-1604905920-9w96k 0/1 Completed 0 2m51s
hello-1604905980-cqgd2 0/1 Completed 0 2m
hello-1604906040-m5h8w 0/1 Completed 0 59s
[root@k8s-master ~]# kubectl logs hello-1604906040-m5h8w
hellow k8s job!