CronJob

当前使用的 Kubernetes 集群，版本 >= 1.8（对 CronJob）

对于先前版本的集群，版本 < 1.8，启动 API Server时，通过传递选项 --runtime-config=batch/v2alpha1=true 可以开启 batch/v2alpha1 API

典型的用法如下所示：

• 在给定的时间点调度 Job 运行

• 创建周期性运行的 Job

  例如：数据库备份、发送邮件
  

• .spec.schedule ： 调度 ，必需字段，指定 任务运行周期 ，格式同 Cron
• .spec.jobTemplate ： Job 模板 ，必需字段，指定需要 运行的任务 ，格式同 Job
• .spec.startingDeadlineSeconds ： 启动 Job 的期限 （ 秒级别 ），该字段是可选的
  • 如果因为任何原因而错过了被调度的时间，那么错过执行时间的 Job 将被认为是失败的
  • 如果没有指定，则没有期限
• .spec.concurrencyPolicy ： 并发策略 ，该字段也是可选的。它指定了如何处理被 Cron Job 创建的 Job 的并发执行。只允许指定下面策略中的一种：
  • Allow （默认）： 允许 并发运行 Job
  • Forbid ： 禁止 并发运行，如果前一个还没有完成，则直接跳过下一个

  • Replace ： 取消当前 正在运行的 Job，用一个 新的来替换

    注意，当前策略只能应用于同一个 Cron Job 创建的 Job
    
    如果存在多个 Cron Job，它们创建的 Job 之间总是允许并发运行
    

• .spec.suspend ：挂起，该字段也是可选的，默认值为 false
  • 如果设置为 true ， 后续所有执行都会被挂起
  • 它对已经开始执行的 Job 不起作用
• .spec.successfulJobsHistoryLimit 和 .spec.failedJobsHistoryLimit ： 历史限制 ，是可选的字段。它们指定了可以 保留 多少 完成 和 失败 的 Job
  • 默认情况下，它们分别设置为 3 和 1
  • 设置限制的值为 0 ，相关类型的 Job 完成后将不会被保留

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

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

当然，也可以用 kubectl run 来创建一个CronJob：

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

$ kubectl get cronjob
NAME      SCHEDULE      SUSPEND   ACTIVE    LAST-SCHEDULE
hello     */1 * * * *   False     0         <none>
$ kubectl get jobs
NAME               DESIRED   SUCCESSFUL   AGE
hello-1202039034   1         1            49s
$ pods=$(kubectl get pods --selector=job-name=hello-1202039034 --output=jsonpath={.items..metadata.name})
$ kubectl logs $pods
Mon Aug 29 21:34:09 UTC 2016
Hello from the Kubernetes cluster

# 注意，删除 cronjob 的时候不会自动删除 job，这些 job 可以用 kubectl delete job 来删除
$ kubectl delete cronjob hello
cronjob "hello" deleted

Cron Job 在每次调度运行时间内 大概 会创建一个 Job 对象。之所以说 大概 ，是因为在特定的环境下可能会创建两个 Job，或者一个 Job 都没创建

只能尽量避免少发生这种情况，但却不能完全避免。因此，创建 Job 操作必须是 幂等的

Cron Job 根本就不会去检查 Pod

Job 根据它所创建的 Pod 的并行度，负责重试创建 Pod，并就决定这一组 Pod 的成功或失败

一旦不再需要 Cron Job，简单地可以使用 kubectl 命令删除它：

$ kubectl delete cronjob hello
cronjob "hello" deleted

这将会终止正在创建的 Job。然而，运行中的 Job 将不会被终止，不会删除 Job 或 它们的 Pod

为了清理那些 Job 和 Pod，需要列出该 Cron Job 创建的全部 Job，然后删除它们：

$ kubectl get jobs
NAME               DESIRED   SUCCESSFUL   AGE
hello-1201907962   1         1            11m
hello-1202039034   1         1            8m
...

$ kubectl delete jobs hello-1201907962 hello-1202039034 ...
job "hello-1201907962" deleted
job "hello-1202039034" deleted

一旦 Job 被删除，由 Job 创建的 Pod 也会被删除

注意，所有由名称为 “hello” 的 Cron Job 创建的 Job 会以前缀字符串 “hello-” 进行命名

如果想要删除当前 Namespace 中的所有 Job，可以通过命令 kubectl delete jobs –all 立刻删除它们

Next：水平自动扩展

Previous: Job

Home：Controller