kubernetes对象之cronjob

系列目录

类似于Linux的Cron模块，CronJob用来运行定时性任务，或者周期性、重复性任务。注意CronJob启动的是kubernetes中的Job，不是ReplicaSet、DaemonSet等其它控制器类型。

示例:

以下CronJob每分钟运行一次，打印出当前时间与hello消息。

• CronJob SPEC:

apiVersion: batch/v1beta1
kind: CronJob
metadata:
  name: hello
spec:
  schedule: "*/1 * * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: hello
            image: busybox
            args:
            - /bin/sh
            - -c
            - date; echo Hello from the Kubernetes cluster
          restartPolicy: OnFailure

以上内容，schedule: "*/1 * * * *"与Linux Cron意义相同，表示每分钟启动一次。

• 运行CronJob

$ kubectl create -f ./cronjob.yaml
cronjob "hello" created

或者通过祈使命令行方式：

$ kubectl run hello --schedule="*/1 * * * *" --restart=OnFailure --image=busybox -- /bin/sh -c "date; echo Hello from the Kubernetes cluster"
cronjob "hello" created

查看CronJob状态：

$ kubectl get cronjob hello
NAME      SCHEDULE      SUSPEND   ACTIVE    LAST-SCHEDULE
hello     */1 * * * *   False     0         <none>

• NAME：CronJob名称。

• SCHEDULE：基于时间的调度规则。

• SUSPEND：如果其值为True表示此CronJob暂时失效，不变成False之前不再创建新任务。对于已经创建的任务没有影响。

• ACTIVE：表示当前活动的任务数，0表示当前没有活动任务。1表示有一个活动任务。此值可能大于1，原因如下：

1. 任务允许重复启动，如前一次启动后还没有退出，下一次已经启动。
2. 允许延后启动，当CronJob Controller发现因为某种原因错误启动，并且任务允许延后启动，则会启动任务。

• LAST-SCHEDULE：表示最后一次调度时间，表示未曾调度过任务。

从CronJob状态可以看出，其输出中并没有相关字段指示其所创建的JOB是否运行成功，运行如上命令查看JOB的详细信息：

查看CronJob创建的Job：

$ kubectl get jobs --watch
NAME               DESIRED   SUCCESSFUL   AGE
hello-4111706356   1         1         2s

• NAME：表示CronJob创建的Job名称，后边的数字由系统自动生成，保证不重复。

• DESIRED：表示CronJob只创建的是最简单的一次Job，只创建一个pod。

• SUCCESSFUL：表示pod成功个数。

• AGE：表示上JOB生存时间。

再次查看CronJob:

$ kubectl get cronjob hello
NAME      SCHEDULE      SUSPEND   ACTIVE    LAST-SCHEDULE
hello     */1 * * * *   False     0         Mon, 29 Aug 2016 14:34:00 -0700

LAST-SCHEDULE表示最近一次调度时间，ACTIVE为０表示实例已经运行结束。

CronJob创建Job，Job创建pod，已经获知CronJob创建的Job名称：hello-4111706356，查看pod方法如下：

# Replace "hello-4111706356" with the job name in your system
$ pods=$(kubectl get pods --show-all --selector=job-name=hello-4111706356 --output=jsonpath={.items..metadata.name})

$ echo $pods
hello-4111706356-o9qcm

$ kubectl logs $pods
Mon Aug 29 21:34:09 UTC 2016
Hello from the Kubernetes cluster

删除CronJob：

$ kubectl delete cronjob hello
cronjob "hello" deleted

删除CronJob会导致其创建的Job、pod一起被删除。

简单起见，以上示例控制CronJob行为的字段没有设置或者也可以说是采用了默认值，下面解释CronJob中的重要字段。

• .spec.startingDeadlineSeconds：单位是秒，表示如果Job因为某种原因无法按调度准时启动，在spec.startingDeadlineSeconds时间段之内，CronJob仍然试图重新启动Job，如果在.spec.startingDeadlineSeconds时间之内没有启动成功，则不再试图重新启动。如果spec.startingDeadlineSeconds的值没有设置，则没有按时启动的任务不会被尝试重新启动。spec.startingDeadlineSeconds同时也影响到CronJob计算任务损失率。如果指定，那么CronJob计算有多少Job没有按时启动时是从当前时间向后推spec.startingDeadlineSeconds秒数，如果没有指定，那么是从当前时间向后推到最后一次成功调度的时间。无论那种算法，如果损失的按时任务超过一定个数，那么CronJob会报错并停止运行。

• .spec.concurrencyPolicy：是否允许Job并发，可能的聚会有３个。
  
  Allow：上一次Job没有完成，本次Job可以启动。
  
  Forbid：上一次Job没有完成，本次Job不可以启动。
  
  Replace：上一次Job没有完成，本次Job取而代之，将上一次Job杀死。

• .spec.suspend：true或者false，表示是否临时阻塞CronJob。

• .spec.successfulJobsHistoryLimit：保存成功历史Job的数量，默认３，如果为０则CronJob在Job成功后立即删除。

• .spec.failedJobsHistoryLimit：保存失败历史Job的数量，默认１，如果为0则CronJob在Job失败后立即删除。