diff --git a/content/zh-cn/docs/reference/kubernetes-api/workload-resources/job-v1.md b/content/zh-cn/docs/reference/kubernetes-api/workload-resources/job-v1.md index 03ba7fc8292..c847b050409 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/workload-resources/job-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/workload-resources/job-v1.md @@ -8,7 +8,6 @@ description: "Job 表示单个任务的配置。" title: "Job" weight: 9 --- - - **metadata** (}}">ObjectMeta) - 标准的对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + 标准的对象元数据。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **spec** (}}">JobSpec) - 任务的预期行为的规约。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status + 任务的预期行为的规约。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status - **status** (}}">JobStatus) - 任务的当前状态。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status - + 任务的当前状态。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status ## JobSpec {#JobSpec} @@ -80,7 +81,7 @@ JobSpec 描述了任务执行的情况。 - **template** (}}">PodTemplateSpec), 必需 - 描述执行任务时将创建的 Pod。更多信息: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ + 描述执行任务时将创建的 Pod。template.spec.restartPolicy 可以取的值只能是 + "Never" 或 "OnFailure"。更多信息: + https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ - **parallelism** (int32) 指定任务应在任何给定时刻预期运行的 Pod 个数上限。 当(.spec.completions - .status.successful) \< .spec.parallelism 时, 即当剩余的工作小于最大并行度时,在稳定状态下运行的 Pod 的实际数量将小于此数量。 - 更多信息: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ + 更多信息: + https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ ### Lifecycle - **completions** (int32) - 指定任务应该运行并预期成功完成的 Pod 个数。设置为 nil 意味着任何 Pod 的成功都标识着所有 Pod 的成功, + 指定任务应该运行并预期成功完成的 Pod 个数。设置为空意味着任何 Pod 的成功都标识着所有 Pod 的成功, 并允许 parallelism 设置为任何正值。设置为 1 意味着并行性被限制为 1,并且该 Pod 的成功标志着任务的成功。更多信息: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ - **completionMode** (string) - completionMode 指定如何跟踪 Pod 完成情况。它可以是 `NonIndexed` (默认) 或者 `Indexed`。 + completionMode 指定如何跟踪 Pod 完成情况。它可以是 `NonIndexed`(默认)或者 `Indexed`。 `NonIndexed` 表示当有 `.spec.completions` 个成功完成的 Pod 时,认为 Job 完成。每个 Pod 完成都是彼此同源的。 @@ -175,7 +179,7 @@ JobSpec 描述了任务执行的情况。 - **suspend** (boolean) @@ -205,9 +209,9 @@ JobSpec 描述了任务执行的情况。 manualSelector 控制 Pod 标签和 Pod 选择器的生成。除非你确定你在做什么,否则不要设置 `manualSelector`。 当此字段为 false 或未设置时,系统会选择此 Pod 唯一的标签并将这些标签附加到 Pod 模板。 当此字段为 true 时,用户负责选择唯一标签并指定选择器。 - 未能选择唯一标签可能会导致此任务和其他任务无法正常运行。 - 但是,你可能会在使用旧的 `extensions/v1beta1` API 创建的任务中看到 `manualSelector=true`。 - 更多信息: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/#specifying-your-own-pod-selector + 未能选择唯一标签可能会导致此任务和其他任务无法正常运行。但是,你可能会在使用旧的 `extensions/v1beta1` API + 创建的任务中看到 `manualSelector=true`。更多信息: + https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/#specifying-your-own-pod-selector -### Alpha 级别 +### Alpha 级别 {#alpha-level} - **podFailurePolicy** (PodFailurePolicy) @@ -254,12 +258,12 @@ JobSpec 描述了任务执行的情况。 **PodFailurePolicyRule 描述当满足要求时如何处理一个 Pod 失效。 - 在每个规则中可以使用 OnExitCodes 和 onPodConditions 之一,但不能同时使用二者。** + 在每个规则中可以使用 onExitCodes 和 onPodConditions 之一,但不能同时使用二者。** - **completedIndexes** (string) @@ -516,11 +522,11 @@ JobStatus 表示 Job 的当前状态。 - **conditions.status** (string), 必需 - 状况的状态,True、False、Unknown 之一。 + 状况的状态:True、False、Unknown 之一。 - **conditions.type** (string), 必需 - 任务状况的类型,Completed 或 Failed。 + 任务状况的类型:Completed 或 Failed。 - **conditions.lastProbeTime** (Time) @@ -531,6 +537,7 @@ JobStatus 表示 Job 的当前状态。 *Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.* --> + **Time 是对 time.Time 的封装,支持正确编码为 YAML 和 JSON。我们为 time 包提供的许多工厂方法提供了封装器。** + **Time 是 time.Time 的包装器,支持正确编码为 YAML 和 JSON。time 包提供的许多工厂方法都提供了包装器。** - - **uncountedTerminatedPods** (UncountedTerminatedPods) UncountedTerminatedPods 保存已终止但尚未被任务控制器纳入状态计数器中的 Pod 的 UID 的集合。 任务控制器所创建 Pod 带有终结器。当 Pod 终止(成功或失败)时,控制器将执行三个步骤以在任务状态中对其进行说明: - (1)将 Pod UID 添加到此字段的列表中。(2)去掉 Pod 中的终结器。(3)从数组中删除 Pod UID,同时为相应的计数器加一。 + + 1. 将 Pod UID 添加到此字段的列表中。 + 2. 去掉 Pod 中的终结器。 + 3. 从数组中删除 Pod UID,同时为相应的计数器加一。 - **uncountedTerminatedPods.failed** ([]string) @@ -613,8 +625,8 @@ JobStatus 表示 Job 的当前状态。 - **uncountedTerminatedPods.succeeded** ([]string) *Set: unique values will be kept during a merge* - - Succeeded holds UIDs of succeeded Pods. + + succeeded holds UIDs of succeeded Pods. --> - **uncountedTerminatedPods.succeeded** ([]string) @@ -626,7 +638,7 @@ JobStatus 表示 Job 的当前状态。 -### Beta 级别 +### Beta 级别 {#beta-level} - - **ready** (int32) 状况为 Ready 的 Pod 数量。 @@ -667,7 +678,8 @@ JobList 是 Job 的集合。 - **metadata** (}}">ListMeta) - 标准列表元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata + 标准列表元数据。更多信息: + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **items** ([]}}">Job), required @@ -676,7 +688,6 @@ JobList 是 Job 的集合。 - ## 操作 {#Operations}