使用 CronJob 运行自动化任务

你可以利用 CronJobs 执行基于时间调度的任务。这些自动化任务和 Linux 或者 Unix 系统的任务类似。

CronJobs 在创建周期性以及重复性的任务时很有帮助，例如执行备份操作或者发送邮件。CronJobs 也可以在特定时间调度单个任务，例如你想调度低活跃周期的任务。

CronJobs 有一些限制和特点。例如，在特定状况下，同一个 CronJob 可以创建多个任务。因此，任务应该是幂等的。

查看更多限制，请参考 CronJobs。

你必须拥有一个 Kubernetes 的集群，同时你的 Kubernetes 集群必须带有 kubectl 命令行工具。建议在至少有两个节点的集群上运行本教程，且这些节点不作为控制平面主机。如果你还没有集群，你可以通过构建一个你自己的集群，或者你可以使用下面任意一个 Kubernetes 工具构建：
- Katacoda
Your Kubernetes server must be at or later than version v1.21. To check the version, enter kubectl version.

CronJob 需要一个配置文件。本例中 CronJob 的.spec 配置文件每分钟打印出当前时间和一个问好信息：

想要运行示例的 CronJob，可以下载示例文件并执行命令：

kubectl create -f https://k8s.io/examples/application/job/cronjob.yaml

cronjob.batch/hello created

创建好 CronJob 后，使用下面的命令来获取其状态：

kubectl get cronjob hello

输出类似于：

就像你从命令返回结果看到的那样，CronJob 还没有调度或执行任何任务。大约需要一分钟任务才能创建好。

kubectl get jobs --watch

NAME               COMPLETIONS   DURATION   AGE
hello-4111706356   0/1                      0s
hello-4111706356   1/1           5s         5s

kubectl get cronjob hello

输出类似于：

你应该能看到 hello CronJob 在 LAST SCHEDULE 声明的时间点成功的调度了一次任务。有 0 个活跃的任务意味着任务执行完毕或者执行失败。

现在，找到最后一次调度任务创建的 Pod 并查看一个 Pod 的标准输出。

Note: Job 名称和 Pod 名称不同。

# 在你的系统上将 "hello-4111706356" 替换为 Job 名称
pods=$(kubectl get pods --selector=job-name=hello-4111706356 --output=jsonpath={.items..metadata.name})

查看 Pod 日志：

kubectl logs $pods

输出与此类似：


Hello from the Kubernetes cluster

当你不再需要 CronJob 时，可以用 kubectl delete cronjob <cronjob name> 删掉它：

删除 CronJob 会清除它创建的所有任务和 Pod，并阻止它创建额外的任务。你可以查阅。

像 Kubernetes 的其他配置一样，CronJob 需要 apiVersion、kind、和 metadata 域。配置文件的一般信息，请参考部署应用和 .

CronJob 配置也需要包括 .spec.

Note: 对 CronJob 的所有改动，特别是它的 .spec，只会影响将来的运行实例。

.spec.schedule 是 .spec 需要的域。它使用了格式串，例如 0 * * * * or @hourly ，作为它的任务被创建和执行的调度时间。

Note: 调度中的问号 (?) 和星号 * 含义相同，表示给定域的任何可用值。

是任务的模版，它是必须的。它和的语法完全一样，除了它是嵌套的没有 apiVersion 和 kind。编写任务的 .spec ，请参考编写 Job 的Spec。

.spec.startingDeadlineSeconds 域是可选的。它表示任务如果由于某种原因错过了调度时间，开始该任务的截止时间的秒数。过了截止时间，CronJob 就不会开始任务。不满足这种最后期限的任务会被统计为失败任务。如果该域没有声明，那任务就没有最后期限。

如果.spec.startingDeadlineSeconds字段被设置(非空)，CronJob 控制器会计算从预期创建 Job 到当前时间的时间差。如果时间差大于该限制，则跳过此次执行。

例如，如果将其设置为 200，则 Job 控制器允许在实际调度之后最多 200 秒内创建 Job。

.spec.concurrencyPolicy 也是可选的。它声明了 CronJob 创建的任务执行时发生重叠如何处理。 spec 仅能声明下列规则中的一种：

请注意，并发性规则仅适用于相同 CronJob 创建的任务。如果有多个 CronJob，它们相应的任务总是允许并发执行的。

.spec.suspend域也是可选的。如果设置为 true ，后续发生的执行都会挂起。这个设置对已经开始的执行不起作用。默认是关闭的。

Caution: 在调度时间内挂起的执行都会被统计为错过的任务。当 .spec.suspend 从 true 改为 false 时，且没有开始的最后期限，错过的任务会被立即调度。

.spec.successfulJobsHistoryLimit 和是可选的。这两个字段指定应保留多少已完成和失败的任务。默认设置为3和1。限制设置为 0 代表相应类型的任务完成后不会保留。