From e30a9c786bd8767da2af04ec34e8058afce5a4f8 Mon Sep 17 00:00:00 2001 From: "xin.li" Date: Mon, 8 May 2023 22:07:26 +0800 Subject: [PATCH] [zh-cn] sync some en docs Signed-off-by: xin.li --- .../working-with-objects/owners-dependents.md | 39 ++++++++++--------- content/zh-cn/docs/concepts/windows/intro.md | 7 ---- .../zh-cn/docs/concepts/windows/user-guide.md | 7 ---- .../controller-revision-v1.md | 27 +++++++++++++ .../replication-controller-v1.md | 15 ++++++- .../zh-cn/docs/tutorials/hello-minikube.md | 3 +- .../tutorials/security/cluster-level-pss.md | 4 +- 7 files changed, 66 insertions(+), 36 deletions(-) diff --git a/content/zh-cn/docs/concepts/overview/working-with-objects/owners-dependents.md b/content/zh-cn/docs/concepts/overview/working-with-objects/owners-dependents.md index d7ad4c07ad..08dd39ba2f 100644 --- a/content/zh-cn/docs/concepts/overview/working-with-objects/owners-dependents.md +++ b/content/zh-cn/docs/concepts/overview/working-with-objects/owners-dependents.md @@ -11,20 +11,19 @@ weight: 60 - -在 Kubernetes 中，一些对象是其他对象的“属主（Owner）”。 +在 Kubernetes 中，一些{{< glossary_tooltip text="对象" term_id="Object" >}}是其他对象的“属主（Owner）”。 例如，{{}} 是一组 Pod 的属主。 具有属主的对象是属主的“附属（Dependent）”。 属主关系不同于一些资源使用的[标签和选择算符](/zh-cn/docs/concepts/overview/working-with-objects/labels/)机制。 例如，有一个创建 `EndpointSlice` 对象的 Service， -该 Service 使用标签来让控制平面确定，哪些 `EndpointSlice` 对象属于该 Service。 -除开标签，每个代表 Service 所管理的 `EndpointSlice` 都有一个属主引用。 -属主引用避免 Kubernetes 的不同部分干扰到不受它们控制的对象。 +该 Service 使用{{}}来让控制平面确定哪些 +`EndpointSlice` 对象属于该 Service。除开标签，每个代表 Service 所管理的 +`EndpointSlice` 都有一个属主引用。属主引用避免 Kubernetes +的不同部分干扰到不受它们控制的对象。 ## 对象规约中的属主引用 {#owner-references-in-object-specifications} -附属对象有一个 `metadata.ownerReferences` 字段，用于引用其属主对象。 -一个有效的属主引用，包含与附属对象同在一个命名空间下的对象名称和一个 UID。 +附属对象有一个 `metadata.ownerReferences` 字段，用于引用其属主对象。一个有效的属主引用， +包含与附属对象同在一个{{}}下的对象名称和一个 +{{}}。 Kubernetes 自动为一些对象的附属资源设置属主引用的值， 这些对象包含 ReplicaSet、DaemonSet、Deployment、Job、CronJob、ReplicationController 等。 你也可以通过改变这个字段的值，来手动配置这些关系。 @@ -124,10 +125,10 @@ When you tell Kubernetes to delete a resource, the API server allows the managing controller to process any [finalizer rules](/docs/concepts/overview/working-with-objects/finalizers/) for the resource. {{}} prevent accidental deletion of resources your cluster may still need to function -correctly. For example, if you try to delete a `PersistentVolume` that is still +correctly. For example, if you try to delete a [PersistentVolume](/docs/concepts/storage/persistent-volumes/) that is still in use by a Pod, the deletion does not happen immediately because the `PersistentVolume` has the `kubernetes.io/pv-protection` finalizer on it. -Instead, the volume remains in the `Terminating` status until Kubernetes clears +Instead, the [volume](/docs/concepts/storage/volumes/) remains in the `Terminating` status until Kubernetes clears the finalizer, which only happens after the `PersistentVolume` is no longer bound to a Pod. --> @@ -138,9 +139,11 @@ bound to a Pod. {{}} 防止意外删除你的集群所依赖的、用于正常运作的资源。 例如，如果你试图删除一个仍被 Pod 使用的 `PersistentVolume`，该资源不会被立即删除， -因为 `PersistentVolume` 有 `kubernetes.io/pv-protection` Finalizer。 -相反，它将进入 `Terminating` 状态，直到 Kubernetes 清除这个 Finalizer， -而这种情况只会发生在 `PersistentVolume` 不再被挂载到 Pod 上时。 +因为 [PersistentVolume](/zh-cn/docs/concepts/storage/persistent-volumes/) 有 +`kubernetes.io/pv-protection` Finalizer。 +相反，[数据卷](/zh-cn/docs/concepts/storage/volumes/)将进入 `Terminating` 状态， +直到 Kubernetes 清除这个 Finalizer，而这种情况只会发生在 `PersistentVolume` +不再被挂载到 Pod 上时。 - 从 1.25 开始，`IdentifyPodOS` 特性门控进入 GA 阶段，默认启用。 - {{< /note >}} - -从 1.25 开始，`IdentifyPodOS` 特性处于 GA 阶段，默认启用。 -{{< /note >}} - +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + - **selector** (map[string]string) selector 是针对 Pod 的标签查询，符合条件的 Pod 个数应与 replicas 匹配。 如果 selector 为空，则默认为出现在 Pod 模板中的标签。 如果置空以表示默认使用 Pod 模板中的标签，则标签的主键和取值必须匹配，以便由这个副本控制器进行控制。 + `template.spec.restartPolicy` 唯一被允许的值是 `Always`。 更多信息： https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels/#label-selectors @@ -424,6 +425,10 @@ GET /api/v1/namespaces/{namespace}/replicationcontrollers }}">resourceVersionMatch +- **sendInitialEvents** (*查询参数*): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds @@ -498,6 +503,10 @@ GET /api/v1/replicationcontrollers }}">resourceVersionMatch +- **sendInitialEvents** (*查询参数*): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds @@ -955,6 +964,10 @@ DELETE /api/v1/namespaces/{namespace}/replicationcontrollers }}">resourceVersionMatch +- **sendInitialEvents** (*查询参数*): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds diff --git a/content/zh-cn/docs/tutorials/hello-minikube.md b/content/zh-cn/docs/tutorials/hello-minikube.md index 8f0d46ca3a..19320a751d 100644 --- a/content/zh-cn/docs/tutorials/hello-minikube.md +++ b/content/zh-cn/docs/tutorials/hello-minikube.md @@ -131,7 +131,7 @@ You can run the `dashboard` command again to create another proxy to access the @@ -139,6 +139,7 @@ Open a **new** terminal, and run: `minikube` 会输出一个 URL，你可以在你喜欢的浏览器中打开该 URL。 打开一个**新的**终端，然后运行： + ```shell # 启动一个新的终端，并保持此命令运行。 minikube dashboard --url diff --git a/content/zh-cn/docs/tutorials/security/cluster-level-pss.md b/content/zh-cn/docs/tutorials/security/cluster-level-pss.md index ec97783d6a..50174bd3d6 100644 --- a/content/zh-cn/docs/tutorials/security/cluster-level-pss.md +++ b/content/zh-cn/docs/tutorials/security/cluster-level-pss.md @@ -102,7 +102,7 @@ that are most appropriate for your configuration, do the following: ``` Creating cluster "psa-wo-cluster-pss" ... - ✓ Ensuring node image (kindest/node:v{{< skew currentVersion >}}.0) 🖼 + ✓ Ensuring node image (kindest/node:v{{< skew currentPatchVersion >}}) 🖼 ✓ Preparing nodes 📦 ✓ Writing configuration 📜 ✓ Starting control-plane 🕹️ @@ -398,7 +398,7 @@ following: ``` Creating cluster "psa-with-cluster-pss" ... - ✓ Ensuring node image (kindest/node:v{{< skew currentVersion >}}.0) 🖼 + ✓ Ensuring node image (kindest/node:v{{< skew currentPatchVersion >}}) 🖼 ✓ Preparing nodes 📦 ✓ Writing configuration 📜 ✓ Starting control-plane 🕹️