From fc410a75f2754a52202c97ef74b097724d65b11d Mon Sep 17 00:00:00 2001 From: "xin.li" Date: Thu, 10 Aug 2023 00:17:50 +0800 Subject: [PATCH] [zh-cn] sync workloads/controllers/* labels-annotations-taints/_index.md Signed-off-by: xin.li --- .../workloads/controllers/cron-jobs.md | 2 +- .../workloads/controllers/daemonset.md | 2 +- .../concepts/workloads/controllers/job.md | 39 +----------------- .../workloads/controllers/replicaset.md | 6 +-- .../controllers/replicationcontroller.md | 11 +++-- .../labels-annotations-taints/_index.md | 41 ++++++++----------- 6 files changed, 31 insertions(+), 70 deletions(-) diff --git a/content/zh-cn/docs/concepts/workloads/controllers/cron-jobs.md b/content/zh-cn/docs/concepts/workloads/controllers/cron-jobs.md index 7f6c042ba3..35b771a27f 100644 --- a/content/zh-cn/docs/concepts/workloads/controllers/cron-jobs.md +++ b/content/zh-cn/docs/concepts/workloads/controllers/cron-jobs.md @@ -77,7 +77,7 @@ This example CronJob manifest prints the current time and a hello message every 下面的 CronJob 示例清单会在每分钟打印出当前时间和问候消息： -{{< codenew file="application/job/cronjob.yaml" >}} +{{% code file="application/job/cronjob.yaml" %}} 下面是一个定义了 `podFailurePolicy` 的 Job 的清单： -{{< codenew file="/controllers/job-pod-failure-policy-example.yaml" >}} +{{% code file="/controllers/job-pod-failure-policy-example.yaml" %}} -如果 Job 是在特性门控 `JobTrackingWithFinalizers` 被禁用时创建的，即使你将控制面升级到 1.26， -控制面也不会使用 Finalizer 跟踪 Job。 -{{< /note >}} - 控制面会跟踪属于任何 Job 的 Pod，并通知是否有任何这样的 Pod 被从 API 服务器中移除。 为了实现这一点，Job 控制器创建的 Pod 带有 Finalizer `batch.kubernetes.io/job-tracking`。 控制器只有在 Pod 被记入 Job 状态后才会移除 Finalizer，允许 Pod 可以被其他控制器或用户移除。 -在升级到 Kubernetes 1.26 之前或在启用特性门控 `JobTrackingWithFinalizers` -之前创建的 Job 被跟踪时不使用 Pod Finalizer。 -Job {{< glossary_tooltip term_id="controller" text="控制器" >}}仅根据集群中存在的 Pod -更新 `succeeded` 和 `failed` Pod 的状态计数器。如果 Pod 被从集群中删除，控制面可能无法跟踪 Job 的进度。 - - -你可以根据检查 Job 是否含有 `batch.kubernetes.io/job-tracking` 注解， -来确定控制面是否正在使用 Pod Finalizer 追踪 Job。 -你**不**应该给 Job 手动添加或删除该注解。 -取而代之的是你可以重新创建 Job 以确保使用 Pod Finalizer 跟踪这些 Job。 - diff --git a/content/zh-cn/docs/concepts/workloads/controllers/replicaset.md b/content/zh-cn/docs/concepts/workloads/controllers/replicaset.md index fbe20e17b5..78ce34407c 100644 --- a/content/zh-cn/docs/concepts/workloads/controllers/replicaset.md +++ b/content/zh-cn/docs/concepts/workloads/controllers/replicaset.md @@ -113,7 +113,7 @@ Deployment，并在 spec 部分定义你的应用。 --> ## 示例 {#example} -{{< codenew file="controllers/frontend.yaml" >}} +{{% code file="controllers/frontend.yaml" %}} @@ -34,7 +40,7 @@ always up and available. ### addonmanager.kubernetes.io/mode @@ -785,7 +785,7 @@ For more details, see [Addon-manager](https://github.com/kubernetes/kubernetes/b - `Ignore`：插件资源将被忽略。此模式对于与外接插件管理器不兼容或由其他控制器管理的插件程序非常有用。 有关详细信息，请参见 -[Addon-manager](https://github.com/kubernetes/kubernetes/blob/master/cluster/addons/addon-manager/README.md) +[Addon-manager](https://github.com/kubernetes/kubernetes/blob/master/cluster/addons/addon-manager/README.md)。 Kubernetes 对 Zone 和 Region 的结构做了一些假设： @@ -1540,7 +1540,7 @@ Example: `volume.beta.kubernetes.io/storage-provisioner: "k8s.io/minikube-hostpa Used on: PersistentVolumeClaim This annotation has been deprecated since v1.23. -See [volume.kubernetes.io/storage-provisioner](#volume-kubernetes-io-storage-provisioner) +See [volume.kubernetes.io/storage-provisioner](#volume-kubernetes-io-storage-provisioner). --> ### volume.beta.kubernetes.io/storage-provisioner (已弃用) {#volume-beta-kubernetes-io-storage-provisioner} @@ -1581,7 +1581,7 @@ This annotation has been deprecated. Instead, set the [`storageClassName` field](/docs/concepts/storage/persistent-volumes/#class) for the PersistentVolumeClaim or PersistentVolume. --> -此注解可以为 PersistentVolume (PV) 或 PersistentVolumeClaim (PVC) 指定 +此注解可以为 PersistentVolume（PV）或 PersistentVolumeClaim（PVC）指定 [StorageClass](/zh-cn/docs/concepts/storage/storage-classes/)。 当 `storageClassName` 属性和 `volume.beta.kubernetes.io/storage-class` 注解均被指定时， 注解 `volume.beta.kubernetes.io/storage-class` 将优先于 `storageClassName` 属性。 @@ -1997,7 +1997,7 @@ resource without a class specified will be assigned this default class. 资源将被设置为此默认类。 -### alpha.kubernetes.io/provided-node-ip {#alpha-kubernetes-io-provided-node-ip} +### alpha.kubernetes.io/provided-node-ip (alpha) {#alpha-kubernetes-io-provided-node-ip} 类别：注解 @@ -2094,8 +2094,7 @@ container. 此注解已被弃用。取而代之的是使用 [`kubectl.kubernetes.io/default-container`](#kubectl-kubernetes-io-default-container) 注解。 @@ -2143,11 +2142,8 @@ Example: `batch.kubernetes.io/job-tracking: ""` Used on: Jobs -The presence of this annotation on a Job indicates that the control plane is +The presence of this annotation on a Job used to indicate that the control plane is [tracking the Job status using finalizers](/docs/concepts/workloads/controllers/job/#job-tracking-with-finalizers). -The control plane uses this annotation to safely transition to tracking Jobs -using finalizers, while the feature is in development. -You should **not** manually add or remove this annotation. --> ### batch.kubernetes.io/job-tracking (已弃用) {#batch-kubernetes-io-job-tracking} @@ -2158,18 +2154,13 @@ You should **not** manually add or remove this annotation. 用于：Job Job 上存在此注解表明控制平面正在[使用 Finalizer 追踪 Job](/zh-cn/docs/concepts/workloads/controllers/job/#job-tracking-with-finalizers)。 -控制平面使用此注解来安全地转换为使用 Finalizer 追踪 Job，而此特性正在开发中。 -你 **不** 可以手动添加或删除此注解。 -{{< note >}} -从 Kubernetes 1.26 开始，该注解被弃用。 -Kubernetes 1.27 及以上版本将忽略此注解，并始终使用 Finalizer 追踪 Job。 -{{< /note >}} +添加或删除此注解不再有效（Kubernetes v1.27 及更高版本）， +所有 Job 均通过 Finalizer 进行追踪。