Skip to content

Commit 4155ff4

Browse files
committed
[zh-cn] sync components disruptions validating-webhook-configuration-v1
Signed-off-by: xin.li <[email protected]>
1 parent 0e5ef2d commit 4155ff4

File tree

3 files changed

+69
-45
lines changed

3 files changed

+69
-45
lines changed

content/zh-cn/docs/concepts/overview/components.md

+13-8
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Kubernetes 组件
33
content_type: concept
44
description: >
55
组成 Kubernetes 集群的关键组件概述。
6-
weight: 30
6+
weight: 10
77
card:
88
title: 集群组件
99
name: concepts
@@ -16,7 +16,7 @@ title: Kubernetes Components
1616
content_type: concept
1717
description: >
1818
An overview of the key components that make up a Kubernetes cluster.
19-
weight: 30
19+
weight: 10
2020
card:
2121
title: Components of a cluster
2222
name: concepts
@@ -39,7 +39,8 @@ card:
3939
<!--
4040
## Core Components
4141
42-
A Kubernetes cluster consists of a control plane and one or more worker nodes. Here's a brief overview of the main components:
42+
A Kubernetes cluster consists of a control plane and one or more worker nodes.
43+
Here's a brief overview of the main components:
4344
-->
4445
## 核心组件
4546

@@ -63,7 +64,7 @@ Manage the overall state of the cluster:
6364
: Runs {{< glossary_tooltip text="controllers" term_id="controller" >}} to implement Kubernetes API behavior.
6465
6566
[cloud-controller-manager](/docs/concepts/architecture/#cloud-controller-manager) (optional)
66-
: Integrates with underlying cloud provider(s)
67+
: Integrates with underlying cloud provider(s).
6768
-->
6869
## 控制平面组件(Control Plane Components) {#control-plane-components}
6970

@@ -93,11 +94,12 @@ Run on every node, maintaining running pods and providing the Kubernetes runtime
9394
: Ensures that Pods are running, including their containers.
9495
9596
[kube-proxy](/docs/concepts/architecture/#kube-proxy) (optional)
96-
: Maintains network rules on nodes to implement {{< glossary_tooltip text="Services" term_id="service" >}}
97+
: Maintains network rules on nodes to implement {{< glossary_tooltip text="Services" term_id="service" >}}.
9798
9899
99100
[Container runtime](/docs/concepts/architecture/#container-runtime)
100-
: Software responsible for running containers. Read [Container Runtimes](/docs/setup/production-environment/container-runtimes/) to learn more.
101+
: Software responsible for running containers. Read
102+
[Container Runtimes](/docs/setup/production-environment/container-runtimes/) to learn more.
101103
-->
102104
## Node 组件 {#node-components}
103105

@@ -158,9 +160,12 @@ Addons extend the functionality of Kubernetes. A few important examples include:
158160
<!--
159161
## Flexibility in Architecture
160162
161-
Kubernetes allows for flexibility in how these components are deployed and managed. The architecture can be adapted to various needs, from small development environments to large-scale production deployments.
163+
Kubernetes allows for flexibility in how these components are deployed and managed.
164+
The architecture can be adapted to various needs, from small development environments
165+
to large-scale production deployments.
162166
163-
For more detailed information about each component and various ways to configure your cluster architecture, see the [Cluster Architecture](/docs/concepts/architecture/) page.
167+
For more detailed information about each component and various ways to configure your
168+
cluster architecture, see the [Cluster Architecture](/docs/concepts/architecture/) page.
164169
-->
165170
## 架构灵活性 {#flexibility-in-architecture}
166171

content/zh-cn/docs/concepts/workloads/pods/disruptions.md

+12-18
Original file line numberDiff line numberDiff line change
@@ -443,25 +443,16 @@ can happen, according to:
443443
-->
444444
## Pod 干扰状况 {#pod-disruption-conditions}
445445

446-
{{< feature-state for_k8s_version="v1.26" state="beta" >}}
447-
448-
{{< note >}}
449-
<!--
450-
In order to use this behavior, you must have the `PodDisruptionConditions`
451-
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
452-
enabled in your cluster.
453-
-->
454-
要使用此行为,你必须在集群中启用 `PodDisruptionConditions`
455-
[特性门控](/zh-cn/docs/reference/command-line-tools-reference/feature-gates/)
456-
{{< /note >}}
446+
{{< feature-state feature_gate_name="PodDisruptionConditions" >}}
457447

458448
<!--
459-
When enabled, a dedicated Pod `DisruptionTarget` [condition](/docs/concepts/workloads/pods/pod-lifecycle/#pod-conditions) is added to indicate
449+
A dedicated Pod `DisruptionTarget` [condition](/docs/concepts/workloads/pods/pod-lifecycle/#pod-conditions)
450+
is added to indicate
460451
that the Pod is about to be deleted due to a {{<glossary_tooltip term_id="disruption" text="disruption">}}.
461452
The `reason` field of the condition additionally
462453
indicates one of the following reasons for the Pod termination:
463454
-->
464-
启用后,会给 Pod 添加一个 `DisruptionTarget`
455+
Pod 会被添加一个 `DisruptionTarget`
465456
[状况](/zh-cn/docs/concepts/workloads/pods/pod-lifecycle/#pod-conditions)
466457
用来表明该 Pod 因为发生{{<glossary_tooltip term_id="disruption" text="干扰">}}而被删除。
467458
状况中的 `reason` 字段进一步给出 Pod 终止的原因,如下:
@@ -501,11 +492,15 @@ Taint Manager(`kube-controller-manager` 中节点生命周期控制器的一
501492

502493
<!--
503494
`TerminationByKubelet`
504-
: Pod has been terminated by the kubelet, because of either {{<glossary_tooltip term_id="node-pressure-eviction" text="node pressure eviction">}} or the [graceful node shutdown](/docs/concepts/architecture/nodes/#graceful-node-shutdown).
495+
: Pod has been terminated by the kubelet, because of either {{<glossary_tooltip term_id="node-pressure-eviction" text="node pressure eviction">}},
496+
the [graceful node shutdown](/docs/concepts/architecture/nodes/#graceful-node-shutdown),
497+
or preemption for [system critical pods](/docs/tasks/administer-cluster/guaranteed-scheduling-critical-addon-pods/).
505498
-->
506499
`TerminationByKubelet`
507500
: Pod
508-
由于{{<glossary_tooltip term_id="node-pressure-eviction" text="节点压力驱逐">}}或[节点体面关闭](/zh-cn/docs/concepts/architecture/nodes/#graceful-node-shutdown)而被
501+
由于{{<glossary_tooltip term_id="node-pressure-eviction" text="节点压力驱逐">}}、
502+
[节点体面关闭](/zh-cn/docs/concepts/architecture/nodes/#graceful-node-shutdown)
503+
[系统关键 Pod](/zh-cn/docs/tasks/administer-cluster/guaranteed-scheduling-critical-addon-pods/)的抢占而被
509504
kubelet 终止。
510505

511506
<!--
@@ -533,11 +528,10 @@ Pod 的干扰可能会被中断。控制平面可能会重新尝试继续干扰
533528
{{< /note >}}
534529

535530
<!--
536-
When the `PodDisruptionConditions` feature gate is enabled,
537-
along with cleaning up the pods, the Pod garbage collector (PodGC) will also mark them as failed if they are in a non-terminal
531+
Along with cleaning up the pods, the Pod garbage collector (PodGC) will also mark them as failed if they are in a non-terminal
538532
phase (see also [Pod garbage collection](/docs/concepts/workloads/pods/pod-lifecycle/#pod-garbage-collection)).
539533
-->
540-
`PodDisruptionConditions` 特性门控被启用时,在清理 Pod 的同时,如果这些 Pod 处于非终止阶段,
534+
在清理 Pod 的同时,如果这些 Pod 处于非终止阶段,
541535
则 Pod 垃圾回收器 (PodGC) 也会将这些 Pod 标记为失效
542536
(另见 [Pod 垃圾回收](/zh-cn/docs/concepts/workloads/pods/pod-lifecycle/#pod-garbage-collection))。
543537

content/zh-cn/docs/reference/kubernetes-api/extend-resources/validating-webhook-configuration-v1.md

+44-19
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ api_metadata:
66
content_type: "api_reference"
77
description: "ValidatingWebhookConfiguration 描述准入 Webhook 的配置,该 Webhook 可在不更改对象的情况下接受或拒绝对象请求"
88
title: "ValidatingWebhookConfiguration"
9-
weight: 3
9+
weight: 4
1010
---
1111

1212
<!--
@@ -17,7 +17,7 @@ api_metadata:
1717
content_type: "api_reference"
1818
description: "ValidatingWebhookConfiguration describes the configuration of and admission webhook that accept or reject and object without changing it."
1919
title: "ValidatingWebhookConfiguration"
20-
weight: 3
20+
weight: 4
2121
-->
2222

2323
`apiVersion: admissionregistration.k8s.io/v1`
@@ -51,6 +51,8 @@ ValidatingWebhookConfiguration 描述准入 Webhook 的配置,该 Webhook 可
5151
- **webhooks** ([]ValidatingWebhook)
5252
5353
*Patch strategy: merge on key `name`*
54+
55+
*Map: unique values on key name will be kept during a merge*
5456
5557
Webhooks is a list of webhooks and the affected resources and operations.
5658
@@ -61,6 +63,8 @@ ValidatingWebhookConfiguration 描述准入 Webhook 的配置,该 Webhook 可
6163
- **webhooks** ([]ValidatingWebhook)
6264

6365
**补丁策略:根据 `name` 键执行合并操作**
66+
67+
**Map:name 键的唯一值将在合并期间保留**
6468

6569
webhooks 是 Webhook 以及受影响的资源和操作的列表。
6670

@@ -69,12 +73,16 @@ ValidatingWebhookConfiguration 描述准入 Webhook 的配置,该 Webhook 可
6973

7074
<!--
7175
- **webhooks.admissionReviewVersions** ([]string), required
76+
77+
*Atomic: will be replaced during a merge*
7278
7379
AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions specified in this list supported by API server, validation will fail for this object. If a persisted webhook configuration specifies allowed versions and does not include any versions known to the API Server, calls to the webhook will fail and be subject to the failure policy.
7480
-->
7581

7682
- **webhooks.admissionReviewVersions** ([]string), 必需
7783

84+
**Atomic:将在合并期间被替换**
85+
7886
admissionReviewVersions 是 Webhook 期望的首选 `AdmissionReview` 版本的有序列表。
7987
API 服务器将尝试使用它支持的列表中的第一个版本。如果 API 服务器不支持此列表中指定的版本,则此对象将验证失败。
8088
如果持久化的 Webhook 配置指定了允许的版本,并且不包括 API 服务器已知的任何版本,则对 Webhook 的调用将失败并受失败策略的约束。
@@ -266,13 +274,9 @@ ValidatingWebhookConfiguration 描述准入 Webhook 的配置,该 Webhook 可
266274
- 如果 failurePolicy=Ignore,忽略错误并跳过该 webhook。
267275

268276
<!--
269-
This is an beta feature and managed by the AdmissionWebhookMatchConditions feature gate.
270-
271277
<a name="MatchCondition"></a>
272278
*MatchCondition represents a condition which must by fulfilled for a request to be sent to a webhook.*
273279
-->
274-
这是一个 Beta 功能特性,由 AdmissionWebhookMatchConditions 特性门控管理。
275-
276280
<a name="MatchCondition"></a>
277281
**MatchCondition 表示将请求发送到 Webhook 之前必须满足的条件。**
278282

@@ -432,6 +436,8 @@ ValidatingWebhookConfiguration 描述准入 Webhook 的配置,该 Webhook 可
432436
433437
<!--
434438
- **webhooks.rules** ([]RuleWithOperations)
439+
440+
*Atomic: will be replaced during a merge*
435441
436442
Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches _any_ Rule. However, in order to prevent ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks from putting the cluster in a state which cannot be recovered from without completely disabling the plugin, ValidatingAdmissionWebhooks and MutatingAdmissionWebhooks are never called on admission requests for ValidatingWebhookConfiguration and MutatingWebhookConfiguration objects.
437443
@@ -441,6 +447,8 @@ ValidatingWebhookConfiguration 描述准入 Webhook 的配置,该 Webhook 可
441447
442448
- **webhooks.rules** ([]RuleWithOperations)
443449
450+
**Atomic:将在合并期间被替换**
451+
444452
rules 描述了 Webhook 关心的资源/子资源上有哪些操作。Webhook 关心操作是否匹配**任何**rules。
445453
但是,为了防止 ValidatingAdmissionWebhooks 和 MutatingAdmissionWebhooks 将集群置于只能完全禁用插件才能恢复的状态,
446454
ValidatingAdmissionWebhooks 和 MutatingAdmissionWebhooks 永远不会在处理 ValidatingWebhookConfiguration
@@ -559,29 +567,46 @@ ValidatingWebhookConfigurationList 是 ValidatingWebhookConfiguration 的列表
559567
560568
<hr>
561569
562-
- **apiVersion**: admissionregistration.k8s.io/v1
570+
<!--
571+
- **items** ([]<a href="{{< ref "../extend-resources/validating-webhook-configuration-v1#ValidatingWebhookConfiguration" >}}">ValidatingWebhookConfiguration</a>), required
572+
573+
List of ValidatingWebhookConfiguration.
574+
-->
563575
564-
- **kind**: ValidatingWebhookConfigurationList
576+
- **items** ([]<a href="{{< ref "../extend-resources/validating-webhook-configuration-v1#ValidatingWebhookConfiguration" >}}">ValidatingWebhookConfiguration</a>), 必需
577+
578+
ValidatingWebhookConfiguration 列表。
579+
580+
<!--
581+
- **apiVersion** (string)
565582
566-
<!--
567-
- **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
583+
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
584+
-->
568585
569-
Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
586+
apiVersion 定义对象表示的版本化模式。服务器应将已识别的模式转换为最新的内部值,并可能拒绝未识别的值。
587+
更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
588+
589+
<!--
590+
- **kind** (string)
591+
592+
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
570593
-->
594+
- **kind**(string)
571595
572-
- **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
596+
kind 是一个字符串值,表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出资源类别。
597+
无法更新。采用驼峰式命名。更多信息:
598+
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
573599
574-
标准的对象元数据,更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds。
575600
576-
<!--
577-
- **items** ([]<a href="{{< ref "../extend-resources/validating-webhook-configuration-v1#ValidatingWebhookConfiguration" >}}">ValidatingWebhookConfiguration</a>), required
601+
<!--
602+
- **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
578603
579-
List of ValidatingWebhookConfiguration.
604+
Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
580605
-->
606+
- **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
581607
582-
- **items** ([]<a href="{{< ref "../extend-resources/validating-webhook-configuration-v1#ValidatingWebhookConfiguration" >}}">ValidatingWebhookConfiguration</a>), 必需
583-
584-
ValidatingWebhookConfiguration 列表。
608+
标准的列表元数据。更多信息:
609+
https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
585610
586611
<!--
587612
## Operations {#Operations}

0 commit comments

Comments
 (0)