From 0c8343e4b01c39b9298f7ba656130a2ea5d22c7c Mon Sep 17 00:00:00 2001 From: windsonsea Date: Fri, 24 Jun 2022 10:43:07 +0800 Subject: [PATCH] [zh] text optimization: automated-tasks-with-cron-jobs.md --- .../job/automated-tasks-with-cron-jobs.md | 109 ++++++++++-------- 1 file changed, 58 insertions(+), 51 deletions(-) diff --git a/content/zh-cn/docs/tasks/job/automated-tasks-with-cron-jobs.md b/content/zh-cn/docs/tasks/job/automated-tasks-with-cron-jobs.md index ec2189c594..5e67e5bb39 100644 --- a/content/zh-cn/docs/tasks/job/automated-tasks-with-cron-jobs.md +++ b/content/zh-cn/docs/tasks/job/automated-tasks-with-cron-jobs.md @@ -1,39 +1,42 @@ --- title: 使用 CronJob 运行自动化任务 +min-kubernetes-server-version: v1.21 content_type: task weight: 10 -min-kubernetes-server-version: v1.21 --- - -在Kubernetes v1.21 版本中，CronJob 被提升为通用版本。如果你使用的是旧版本的 Kubernetes，请参考你正在使用的 Kubernetes 版本的文档，这样你就能看到准确的信息。旧的 Kubernetes 版本不支持`batch/v1` CronJob API。 +在 Kubernetes v1.21 版本中，CronJob 被提升为通用版本。如果你使用的是旧版本的 Kubernetes， +请参考你正在使用的 Kubernetes 版本的文档，这样你就能看到准确的信息。 +旧的 Kubernetes 版本不支持 `batch/v1` CronJob API。 -你可以利用 [CronJobs](/zh-cn/docs/concepts/workloads/controllers/cron-jobs) 执行基于时间调度的任务。这些自动化任务和 Linux 或者 Unix 系统的 [Cron](https://en.wikipedia.org/wiki/Cron) 任务类似。 +你可以利用 {{< glossary_tooltip text="CronJob" term_id="cronjob" >}} +执行基于时间调度的 {{< glossary_tooltip text="Job" term_id="job" >}}。 +这些自动化任务和 Linux 或者 Unix 系统的 [Cron](https://zh.wikipedia.org/wiki/Cron) 任务类似。 -CronJobs 在创建周期性以及重复性的任务时很有帮助，例如执行备份操作或者发送邮件。CronJobs 也可以在特定时间调度单个任务，例如你想调度低活跃周期的任务。 +CronJob 在创建周期性以及重复性的任务时很有帮助，例如执行备份操作或者发送邮件。 +CronJob 也可以在特定时间调度单个任务，例如你想调度低活跃周期的任务。 -CronJobs 有一些限制和特点。 +CronJob 有一些限制和特点。 例如，在特定状况下，同一个 CronJob 可以创建多个任务。 因此，任务应该是幂等的。 -查看更多限制，请参考 [CronJobs](/zh-cn/docs/concepts/workloads/controllers/cron-jobs)。 +有关更多限制，请参考 [CronJob](/zh-cn/docs/concepts/workloads/controllers/cron-jobs)。 ## {{% heading "prerequisites" %}} - * {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} @@ -60,7 +62,7 @@ CronJobs 有一些限制和特点。 Cron jobs require a config file. This example cron job config `.spec` file prints the current time and a hello message every minute: --> -## 创建 CronJob +## 创建 CronJob {#creating-a-cronjob} CronJob 需要一个配置文件。 本例中 CronJob 的`.spec` 配置文件每分钟打印出当前时间和一个问好信息： @@ -68,13 +70,19 @@ CronJob 需要一个配置文件。 {{< codenew file="application/job/cronjob.yaml" >}} -想要运行示例的 CronJob，可以下载示例文件并执行命令： +执行以下命令以运行此 CronJob 示例： ```shell kubectl create -f https://k8s.io/examples/application/job/cronjob.yaml ``` + + +输出类似于： + ``` cronjob.batch/hello created ``` @@ -140,8 +148,8 @@ You should see that the cron job `hello` successfully scheduled a job at the tim Now, find the pods that the last scheduled job created and view the standard output of one of the pods. --> -你应该能看到 `hello` CronJob 在 `LAST SCHEDULE` 声明的时间点成功的调度了一次任务。 -有 0 个活跃的任务意味着任务执行完毕或者执行失败。 +你应该能看到 `hello` CronJob 在 `LAST SCHEDULE` 声明的时间点成功地调度了一次任务。 +目前有 0 个活跃的任务，这意味着任务执行完毕或者执行失败。 现在，找到最后一次调度任务创建的 Pod 并查看一个 Pod 的标准输出。 @@ -149,7 +157,7 @@ Now, find the pods that the last scheduled job created and view the standard out The job name and pod name are different. --> {{< note >}} -Job 名称和 Pod 名称不同。 +Job 名称与 Pod 名称不同。 {{< /note >}} ```shell @@ -168,7 +176,7 @@ kubectl logs $pods -输出与此类似： +输出类似于： ``` Fri Feb 22 11:02:09 UTC 2019 @@ -181,7 +189,7 @@ Hello from the Kubernetes cluster When you don't need a cron job any more, delete it with `kubectl delete cronjob `： --> -## 删除 CronJob +## 删除 CronJob {#deleting-a-cronjob} 当你不再需要 CronJob 时，可以用 `kubectl delete cronjob ` 删掉它： @@ -205,15 +213,15 @@ and [using kubectl to manage resources](/docs/concepts/overview/working-with-obj A cron job config also needs a [`.spec` section](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status). --> -## 编写 CronJob 声明信息 +## 编写 CronJob 声明信息 {#writing-a-cronjob-spec} -像 Kubernetes 的其他配置一样，CronJob 需要 `apiVersion`、`kind`、和 `metadata` 域。 -配置文件的一般信息，请参考 +像 Kubernetes 的其他配置一样，CronJob 需要 `apiVersion`、`kind` 和 `metadata` 字段。 +有关配置文件的一般信息，请参考 [部署应用](/zh-cn/docs/tasks/run-application/run-stateless-application-deployment/) 和 -[使用 kubectl 管理资源](/zh-cn/docs/concepts/overview/working-with-objects/object-management/). +[使用 kubectl 管理资源](/zh-cn/docs/concepts/overview/working-with-objects/object-management/)。 CronJob 配置也需要包括 -[`.spec`](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status). +[`.spec`](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status)。 -### 时间安排 +### 时间安排 {#schedule} -`.spec.schedule` 是 `.spec` 需要的域。它使用了 [Cron](https://en.wikipedia.org/wiki/Cron) -格式串，例如 `0 * * * *` or `@hourly` ，作为它的任务被创建和执行的调度时间。 +`.spec.schedule` 是 `.spec` 中的必需字段。它接受 [Cron](https://en.wikipedia.org/wiki/Cron) +格式串，例如 `0 * * * *` or `@hourly`，作为它的任务被创建和执行的调度时间。 -该格式也包含了扩展的 "Vixie cron" 步长值。 +该格式也包含了扩展的 “Vixie cron” 步长值。 [FreeBSD 手册](https://www.freebsd.org/cgi/man.cgi?crontab%285%29)中解释如下: > 步长可被用于范围组合。范围后面带有 `/<数字>` 可以声明范围内的步幅数值。 -> 例如，`0-23/2` 可被用在小时域来声明命令在其他数值的小时数执行 -> （ V7 标准中对应的方法是`0,2,4,6,8,10,12,14,16,18,20,22`）。 -> 步长也可以放在通配符后面，因此如果你想表达 "每两小时"，就用 `*/2` 。 +> 例如，`0-23/2` 可被用在小时字段来声明命令在其他数值的小时数执行 +> （V7 标准中对应的方法是 `0,2,4,6,8,10,12,14,16,18,20,22`）。 +> 步长也可以放在通配符后面，因此如果你想表达 “每两小时”，就用 `*/2` 。 {{< note >}} -调度中的问号 (`?`) 和星号 `*` 含义相同，表示给定域的任何可用值。 +调度中的问号 (`?`) 和星号 `*` 含义相同，表示给定字段的任何可用值。 {{< /note >}} -### 任务模版 +### 任务模板 {#job-template} -`.spec.jobTemplate`是任务的模版，它是必须的。它和 -[Job](/zh-cn/docs/concepts/workloads/controllers/job/)的语法完全一样， -除了它是嵌套的没有 `apiVersion` 和 `kind`。 -编写任务的 `.spec` ，请参考 -[编写 Job 的Spec](/zh-cn/docs/concepts/workloads/controllers/job/#writing-a-job-spec)。 +`.spec.jobTemplate`是任务的模板，它是必需的。它和 +[Job](/zh-cn/docs/concepts/workloads/controllers/job/) 的语法完全一样， +只不过它是嵌套的，没有 `apiVersion` 和 `kind`。 +有关如何编写一个任务的 `.spec`，请参考 +[编写 Job 规约](/zh-cn/docs/concepts/workloads/controllers/job/#writing-a-job-spec)。 -### 开始的最后期限 {#starting-deadline} +### 开始的最后期限 {#starting-deadline} -`.spec.startingDeadlineSeconds` 域是可选的。 +`.spec.startingDeadlineSeconds` 字段是可选的。 它表示任务如果由于某种原因错过了调度时间，开始该任务的截止时间的秒数。过了截止时间，CronJob 就不会开始任务。 -不满足这种最后期限的任务会被统计为失败任务。如果该域没有声明，那任务就没有最后期限。 +不满足这种最后期限的任务会被统计为失败任务。如果此字段未设置，那任务就没有最后期限。 -如果`.spec.startingDeadlineSeconds`字段被设置(非空)，CronJob 控制器会计算从预期创建 Job 到当前时间的时间差。 +如果 `.spec.startingDeadlineSeconds` 字段被设置（非空）， +CronJob 控制器将会计算从预期创建 Job 到当前时间的时间差。 如果时间差大于该限制，则跳过此次执行。 例如，如果将其设置为 `200`，则 Job 控制器允许在实际调度之后最多 200 秒内创建 Job。 @@ -319,7 +328,7 @@ the spec may specify only one of the following concurrency policies: Note that concurrency policy only applies to the jobs created by the same cron job. If there are multiple cron jobs, their respective jobs are always allowed to run concurrently. --> -### 并发性规则 +### 并发性规则 {#concurrency-policy} `.spec.concurrencyPolicy` 也是可选的。它声明了 CronJob 创建的任务执行时发生重叠如何处理。 spec 仅能声明下列规则中的一种： @@ -338,10 +347,10 @@ If it is set to `true`, all subsequent executions are suspended. This setting does not apply to already started executions. Defaults to false. --> -### 挂起 +### 挂起 {#suspend} -`.spec.suspend`域也是可选的。如果设置为 `true` ，后续发生的执行都会挂起。 -这个设置对已经开始的执行不起作用。默认是关闭的。 +`.spec.suspend` 字段也是可选的。如果设置为 `true` ，后续发生的执行都会被挂起。 +这个设置对已经开始的执行不起作用。默认是 `false`。 {{< caution >}} 在调度时间内挂起的执行都会被统计为错过的任务。当 `.spec.suspend` 从 `true` 改为 `false` 时， -且没有 [开始的最后期限](#starting-deadline)，错过的任务会被立即调度。 +且没有[开始的最后期限](#starting-deadline)，错过的任务会被立即调度。 {{< /caution >}} -### 任务历史限制 +### 任务历史限制 {#jobs-history-limits} `.spec.successfulJobsHistoryLimit` 和 `.spec.failedJobsHistoryLimit`是可选的。 这两个字段指定应保留多少已完成和失败的任务。 -默认设置为3和1。限制设置为 `0` 代表相应类型的任务完成后不会保留。 - - +默认设置分别为 3 和 1。设置为 `0` 代表相应类型的任务完成后不会保留。