Skip to content

Commit be881ec

Browse files
authored
Merge pull request #33125 from tengqm/zh-tweak-nodes-page
[zh] Update the nodes concept page
2 parents 79552a5 + 3660d10 commit be881ec

File tree

1 file changed

+28
-34
lines changed
  • content/zh/docs/concepts/architecture

1 file changed

+28
-34
lines changed

content/zh/docs/concepts/architecture/nodes.md

Lines changed: 28 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ valid. For example, if you try to create a Node from the following JSON manifest
6363
1. 节点上的 `kubelet` 向控制面执行自注册;
6464
2. 你,或者别的什么人,手动添加一个 Node 对象。
6565

66-
在你创建了 Node {{< glossary_tooltip text="object" term_id="object" >}}或者节点上的
66+
在你创建了 Node {{< glossary_tooltip text="对象" term_id="object" >}}或者节点上的
6767
`kubelet` 执行了自注册操作之后,控制面会检查新的 Node 对象是否合法。
6868
例如,如果你尝试使用下面的 JSON 对象来创建 Node 对象:
6969

@@ -100,10 +100,9 @@ it becomes healthy.
100100
You, or a {{< glossary_tooltip term_id="controller" text="controller">}}, must explicitly
101101
delete the Node object to stop that health checking.
102102
-->
103-
Kubernetes 会一直保存着非法节点对应的对象,并持续检查该节点是否已经
104-
变得健康。
105-
你,或者某个{{< glossary_tooltip term_id="controller" text="控制器">}}必需显式地
106-
删除该 Node 对象以停止健康检查操作。
103+
Kubernetes 会一直保存着非法节点对应的对象,并持续检查该节点是否已经变得健康。
104+
你,或者某个{{< glossary_tooltip term_id="controller" text="控制器">}}必须显式地删除该
105+
Node 对象以停止健康检查操作。
107106
{{< /note >}}
108107

109108
<!--
@@ -127,7 +126,7 @@ first and re-added after the update.
127126
-->
128127
### 节点名称唯一性 {#node-name-uniqueness}
129128

130-
节点的[名称](/docs/concepts/overview/working-with-objects/names#names)用来标识 Node 对象。
129+
节点的[名称](/zh/docs/concepts/overview/working-with-objects/names#names)用来标识 Node 对象。
131130
没有两个 Node 可以同时使用相同的名称。 Kubernetes 还假定名字相同的资源是同一个对象。
132131
就 Node 而言,隐式假定使用相同名称的实例会具有相同的状态(例如网络配置、根磁盘内容)
133132
和类似节点标签这类属性。这可能在节点被更改但其名称未变时导致系统状态不一致。
@@ -177,8 +176,8 @@ When the [Node authorization mode](/docs/reference/access-authn-authz/node/) and
177176
kubelets are only authorized to create/modify their own Node resource.
178177
-->
179178
启用[Node 鉴权模式](/zh/docs/reference/access-authn-authz/node/)
180-
[NodeRestriction 准入插件](/zh/docs/reference/access-authn-authz/admission-controllers/#noderestriction)
181-
时,仅授权 `kubelet` 创建或修改其自己的节点资源。
179+
[NodeRestriction 准入插件](/zh/docs/reference/access-authn-authz/admission-controllers/#noderestriction)时,
180+
仅授权 `kubelet` 创建或修改其自己的节点资源。
182181

183182
{{< note >}}
184183
<!--
@@ -257,7 +256,7 @@ kubectl cordon $NODENAME
257256
See [Safely Drain a Node](/docs/tasks/administer-cluster/safely-drain-node/)
258257
for more details.
259258
-->
260-
更多细节参考[安全腾空节点](/zh/docs/tasks/administer-cluster/safely-drain-node/)
259+
更多细节参考[安全地腾空节点](/zh/docs/tasks/administer-cluster/safely-drain-node/)
261260

262261
{{< note >}}
263262
<!--
@@ -285,10 +284,10 @@ A node's status contains the following information:
285284

286285
一个节点的状态包含以下信息:
287286

288-
* [地址](#addresses)
289-
* [状况](#condition)
290-
* [容量与可分配](#capacity)
291-
* [信息](#info)
287+
* [地址(Addresses)](#addresses)
288+
* [状况(Condition)](#condition)
289+
* [容量与可分配(Capacity)](#capacity)
290+
* [信息(Info)](#info)
292291

293292
<!--
294293
You can use `kubectl` to view a Node's status and other details:
@@ -327,7 +326,7 @@ The `conditions` field describes the status of all `Running` nodes. Examples of
327326
-->
328327
### 状况 {#condition}
329328

330-
`conditions` 字段描述了所有 `Running` 节点的状态。状况的示例包括:
329+
`conditions` 字段描述了所有 `Running` 节点的状况。状况的示例包括:
331330

332331
<!--
333332
{{< table caption = "Node conditions, and a description of when each condition applies." >}}
@@ -393,7 +392,7 @@ for all Pods assigned to that node. The default eviction timeout duration is
393392
如果 Ready 状况的 `status` 处于 `Unknown` 或者 `False` 状态的时间超过了
394393
`pod-eviction-timeout` 值(一个传递给
395394
{{< glossary_tooltip text="kube-controller-manager" term_id="kube-controller-manager" >}}
396-
的参数),[节点控制器](#node-controller) 会对节点上的所有 Pod 触发
395+
的参数),[节点控制器](#node-controller)会对节点上的所有 Pod 触发
397396
{{< glossary_tooltip text="API-发起的驱逐" term_id="api-eviction" >}}。
398397
默认的逐出超时时长为 **5 分钟**
399398

@@ -417,7 +416,7 @@ all the Pod objects running on the node to be deleted from the API server, and f
417416
names.
418417
-->
419418
节点控制器在确认 Pod 在集群中已经停止运行前,不会强制删除它们。
420-
你可以看到这些可能在无法访问的节点上运行的 Pod 处于 `Terminating` 或者 `Unknown` 状态。
419+
你可以看到可能在这些无法访问的节点上运行的 Pod 处于 `Terminating` 或者 `Unknown` 状态。
421420
如果 kubernetes 不能基于下层基础设施推断出某节点是否已经永久离开了集群,
422421
集群管理员可能需要手动删除该节点对象。
423422
从 Kubernetes 删除节点对象将导致 API 服务器删除节点上所有运行的 Pod 对象并释放它们的名字。
@@ -480,7 +479,7 @@ the Kubernetes API.
480479
### 信息(Info) {#info}
481480

482481
Info 指的是节点的一般信息,如内核版本、Kubernetes 版本(`kubelet``kube-proxy` 版本)、
483-
容器运行时详细信息,以及 节点使用的操作系统
482+
容器运行时详细信息,以及节点使用的操作系统
484483
`kubelet` 从节点收集这些信息并将其发布到 Kubernetes API。
485484

486485
<!--
@@ -492,6 +491,7 @@ availability of each node, and to take action when failures are detected.
492491
For nodes there are two forms of heartbeats:
493492
-->
494493
## 心跳 {#heartbeats}
494+
495495
Kubernetes 节点发送的心跳帮助你的集群确定每个节点的可用性,并在检测到故障时采取行动。
496496

497497
对于节点,有两种形式的心跳:
@@ -504,7 +504,7 @@ Kubernetes 节点发送的心跳帮助你的集群确定每个节点的可用性
504504
Each Node has an associated Lease object.
505505
-->
506506
* 更新节点的 `.status`
507-
* `kube-node-lease` {{<glossary_tooltip term_id="namespace" text="命名空间">}}中的
507+
* `kube-node-lease` {{<glossary_tooltip term_id="namespace" text="名字空间">}}中的
508508
[Lease(租约)](/docs/reference/kubernetes-api/cluster-resources/lease-v1/)对象。
509509
每个节点都有一个关联的 Lease 对象。
510510

@@ -588,7 +588,7 @@ This period can be configured using the `--node-monitor-period` flag on the
588588
- 在节点不可达的情况下,在 Node 的 `.status` 中更新 `Ready` 状况。
589589
在这种情况下,节点控制器将 NodeReady 状况更新为 `Unknown`
590590
- 如果节点仍然无法访问:对于不可达节点上的所有 Pod 触发
591-
[API-发起的逐出](/zh/docs/concepts/scheduling-eviction/api-eviction/)
591+
[API 发起的逐出](/zh/docs/concepts/scheduling-eviction/api-eviction/)操作
592592
默认情况下,节点控制器在将节点标记为 `Unknown` 后等待 5 分钟提交第一个驱逐请求。
593593

594594
默认情况下,节点控制器每 5 秒检查一次节点状态,可以使用 `kube-controller-manager`
@@ -772,8 +772,8 @@ Note that by default, both configuration options described below,
772772
thus not activating the graceful node shutdown functionality.
773773
To activate the feature, the two kubelet config settings should be configured appropriately and set to non-zero values.
774774
-->
775-
注意,默认情况下,下面描述的两个配置选项,`ShutdownGracePeriod`
776-
`ShutdownGracePeriodCriticalPods` 都是被设置为 0 的,因此不会激活体面节点关闭功能。
775+
注意,默认情况下,下面描述的两个配置选项,`shutdownGracePeriod`
776+
`shutdownGracePeriodCriticalPods` 都是被设置为 0 的,因此不会激活体面节点关闭功能。
777777
要激活此功能特性,这两个 kubelet 配置选项要适当配置,并设置为非零值。
778778

779779
<!--
@@ -797,12 +797,12 @@ Graceful Node Shutdown feature is configured with two [`KubeletConfiguration`](/
797797
节点体面关闭的特性对应两个
798798
[`KubeletConfiguration`](/zh/docs/tasks/administer-cluster/kubelet-config-file/) 选项:
799799

800-
* `ShutdownGracePeriod`
800+
* `shutdownGracePeriod`
801801
* 指定节点应延迟关闭的总持续时间。此时间是 Pod 体面终止的时间总和,不区分常规 Pod
802802
还是[关键 Pod](/zh/docs/tasks/administer-cluster/guaranteed-scheduling-critical-addon-pods/#marking-pod-as-critical)
803-
* `ShutdownGracePeriodCriticalPods`
803+
* `shutdownGracePeriodCriticalPods`
804804
* 在节点关闭期间指定用于终止[关键 Pod](/zh/docs/tasks/administer-cluster/guaranteed-scheduling-critical-addon-pods/#marking-pod-as-critical)
805-
的持续时间。该值应小于 `ShutdownGracePeriod`
805+
的持续时间。该值应小于 `shutdownGracePeriod`
806806

807807
<!--
808808
For example, if `ShutdownGracePeriod=30s`, and
@@ -811,7 +811,7 @@ For example, if `ShutdownGracePeriod=30s`, and
811811
for gracefully terminating normal pods, and the last 10 seconds would be
812812
reserved for terminating [critical pods](/docs/tasks/administer-cluster/guaranteed-scheduling-critical-addon-pods/#marking-pod-as-critical).
813813
-->
814-
例如,如果设置了 `ShutdownGracePeriod=30s``ShutdownGracePeriodCriticalPods=10s`
814+
例如,如果设置了 `shutdownGracePeriod=30s``shutdownGracePeriodCriticalPods=10s`
815815
则 kubelet 将延迟 30 秒关闭节点。
816816
在关闭期间,将保留前 20(30 - 10)秒用于体面终止常规 Pod,
817817
而保留最后 10 秒用于终止[关键 Pod](/zh/docs/tasks/administer-cluster/guaranteed-scheduling-critical-addon-pods/#marking-pod-as-critical)
@@ -820,11 +820,6 @@ reserved for terminating [critical pods](/docs/tasks/administer-cluster/guarante
820820
When pods were evicted during the graceful node shutdown, they are marked as failed.
821821
Running `kubectl get pods` shows the status of the the evicted pods as `Shutdown`.
822822
And `kubectl describe pod` indicates that the pod was evicted because of node shutdown:
823-
824-
```
825-
Reason: Terminated
826-
Message: Pod was terminated in response to imminent node shutdown.
827-
```
828823
-->
829824
{{< note >}}
830825
当 Pod 在正常节点关闭期间被驱逐时,它们会被标记为已经失败(Failed)。
@@ -973,8 +968,8 @@ containing the pod priority class values and their respective shutdown periods.
973968
-->
974969
如果此功能特性被启用,但没有提供配置数据,则不会出现排序操作。
975970

976-
使用此功能特性需要启用 `GracefulNodeShutdownBasedOnPodPriority` 功能特性
977-
并将 kubelet 配置中的 `ShutdownGracePeriodByPodPriority` 设置为期望的配置,
971+
使用此功能特性需要启用 `GracefulNodeShutdownBasedOnPodPriority` 特性门控
972+
并将 kubelet 配置中的 `shutdownGracePeriodByPodPriority` 设置为期望的配置,
978973
其中包含 Pod 的优先级类数值以及对应的关闭期限。
979974

980975
<!--
@@ -1008,8 +1003,7 @@ must be set to false.
10081003
-->
10091004
要在节点上启用交换内存,必须启用kubelet 的 `NodeSwap` 特性门控,
10101005
同时使用 `--fail-swap-on` 命令行参数或者将 `failSwapOn`
1011-
[配置](/zh/docs/reference/config-api/kubelet-config.v1beta1/#kubelet-config-k8s-io-v1beta1-KubeletConfiguration)
1012-
设置为 false。
1006+
[配置](/zh/docs/reference/config-api/kubelet-config.v1beta1/#kubelet-config-k8s-io-v1beta1-KubeletConfiguration)设置为 false。
10131007

10141008
<!--
10151009
A user can also optionally configure `memorySwap.swapBehavior` in order to

0 commit comments

Comments
 (0)