Skip to content

Commit f074af8

Browse files
committed
sync version-skew-policy.md and configure-upgrade-etcd.md
sync version-skew-policy.md and configure-upgrade-etcd.md
1 parent a5cbdf0 commit f074af8

File tree

2 files changed

+81
-22
lines changed

2 files changed

+81
-22
lines changed

content/zh-cn/docs/tasks/administer-cluster/configure-upgrade-etcd.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -702,3 +702,26 @@ Before you start an upgrade, please back up your etcd cluster first.
702702
在开始升级之前,请先备份你的 etcd 集群。
703703
{{< /note >}}
704704

705+
<!--
706+
## Maintaining etcd clusters
707+
708+
Fore more details on etcd maintenance, please refer to the [etcd maintenance](https://etcd.io/docs/latest/op-guide/maintenance/) documentation.
709+
-->
710+
## 维护 etcd 集群 {#maintaining-etcd-clusters}
711+
712+
有关 etcd 维护的更多详细信息,请参阅 [etcd 维护](https://etcd.io/docs/latest/op-guide/maintenance/)文档。
713+
714+
{{% thirdparty-content single="true" %}}
715+
716+
{{< note >}}
717+
<!--
718+
Defragmentation is an expensive operation, so it should be executed as infrequent
719+
as possible. On the other hand, it's also necessary to make sure any etcd member
720+
will not run out of the storage quota. The Kubernetes project recommends that when
721+
you perform defragmentation, you use a tool such as [etcd-defrag](https://github.com/ahrtr/etcd-defrag).
722+
-->
723+
碎片整理是一种昂贵的操作,因此应尽可能少地执行此操作。
724+
另一方面,也有必要确保任何 etcd 成员都不会用尽存储配额。
725+
Kubernetes 项目建议在执行碎片整理时,
726+
使用诸如 [etcd-defrag](https://github.com/ahrtr/etcd-defrag) 之类的工具。
727+
{{< /note >}}

content/zh-cn/releases/version-skew-policy.md

Lines changed: 58 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,49 @@ Example:
125125
(不支持 **{{< skew currentVersion >}}** 版本,因为这将比
126126
`kube-apiserver` **{{< skew currentVersionAddMinor -1 >}}** 版本的实例新)
127127

128+
<!--
129+
### kube-proxy
130+
131+
`kube-proxy` must not be newer than `kube-apiserver`, and may be up to two minor versions older.
132+
`kube-proxy` may be up to two minor versions older or newer than the `kubelet` instance it runs alongside.
133+
134+
Example:
135+
136+
* `kube-apiserver` is at **{{< skew currentVersion >}}**
137+
* `kube-proxy` is supported at **{{< skew currentVersion >}}**, **{{< skew currentVersionAddMinor -1 >}}**, and **{{< skew currentVersionAddMinor -2 >}}**
138+
-->
139+
### kube-proxy {#kube-proxy}
140+
141+
`kube-proxy` 不能比 `kube-apiserver` 新,并且可以比它旧两个次版本。
142+
`kube-proxy` 可以比一起运行的 `kubelet` 实例旧或新两个次版本。
143+
144+
例如:
145+
146+
* `kube-apiserver` 的版本是 **{{< skew currentVersion >}}**
147+
* `kube-proxy` 支持的版本是 **{{< skew currentVersion >}}**
148+
**{{< skew currentVersionAddMinor -1 >}}****{{< skew currentVersionAddMinor -2 >}}**
149+
150+
{{< note >}}
151+
<!--
152+
If version skew exists between `kube-apiserver` instances in an HA cluster, this narrows the allowed `kube-proxy` versions.
153+
-->
154+
如果在 HA 集群中的 `kube-apiserver` 实例之间存在版本偏差,
155+
所允许的 `kube-proxy` 版本范围会被缩小。
156+
{{</ note >}}
157+
158+
<!--
159+
Example:
160+
161+
* `kube-apiserver` instances are at **{{< skew currentVersion >}}** and **{{< skew currentVersionAddMinor -1 >}}**
162+
* `kube-proxy` is supported at **{{< skew currentVersionAddMinor -1 >}}**, and **{{< skew currentVersionAddMinor -2 >}}** (**{{< skew currentVersion >}}** is not supported because that would be newer than the `kube-apiserver` instance at version **{{< skew currentVersionAddMinor -1 >}}**)
163+
-->
164+
例如:
165+
166+
* `kube-apiserver` 实例的版本是 **{{< skew currentVersion >}}****{{< skew currentVersionAddMinor -1 >}}**
167+
* `kube-proxy` 版本为 **{{< skew currentVersionAddMinor -1 >}}**
168+
**{{< skew currentVersionAddMinor -2 >}}**。(**{{< skew currentVersion >}}** 将不被支持,
169+
因为该版本将比 **{{< skew currentVersionAddMinor -1 >}}** 的 kube-apiserver 实例更新)
170+
128171
<!--
129172
### kube-controller-manager, kube-scheduler, and cloud-controller-manager
130173
@@ -354,38 +397,31 @@ In-place minor version `kubelet` upgrades are not supported.
354397

355398
{{< warning >}}
356399
<!--
357-
Running a cluster with `kubelet` instances that are persistently two minor versions behind `kube-apiserver` is not recommended:
358-
359-
* they must be upgraded within one minor version of `kube-apiserver` before the control plane can be upgraded
360-
* it increases the likelihood of running `kubelet` versions older than the three maintained minor releases
400+
Running a cluster with `kubelet` instances that are persistently two minor versions behind `kube-apiserver` means they must be upgraded before the control plane can be upgraded.
361401
-->
362-
不建议运行 `kubelet` 实例始终落后 `kube-apiserver` 两个次要版本的集群:
363-
364-
* 它们必须在 `kube-apiserver` 的一个次要版本中升级,然后才能升级控制平面
365-
* 它增加了运行早于三个处于维护状态的次要版本的 `kubelet` 的可能性
402+
在一个集群中运行持续比 `kube-apiserver` 落后两个次版本的 `kubelet` 实例意味着在升级控制平面之前必须先升级它们。
366403
{{</ warning >}}
367404

368405
<!--
369406
### kube-proxy
370407
371-
* `kube-proxy` must not be newer than `kube-apiserver`.
372-
* `kube-proxy` must be at most two minor versions older than `kube-apiserver.`
373-
374-
Example:
408+
Pre-requisites:
375409
376-
If `kube-proxy` version is **{{< skew currentVersionAddMinor -2 >}}**:
410+
* The `kube-apiserver` instances `kube-proxy` communicates with are at **{{< skew currentVersion >}}**
377411
378-
* `kubelet` version must be at the same minor version as **{{< skew currentVersionAddMinor -2 >}}**.
379-
* `kube-apiserver` version must be between **{{< skew currentVersionAddMinor -2 >}}** and **{{< skew currentVersion >}}**, inclusive.
412+
Optionally upgrade `kube-proxy` instances to **{{< skew currentVersion >}}** (or they can be left at **{{< skew currentVersionAddMinor -1 >}}** or **{{< skew currentVersionAddMinor -2 >}}**)
380413
-->
381414
### kube-proxy {#kube-proxy}
382415

383-
* `kube-proxy` 版本不能比 `kube-apiserver` 版本新。
384-
* `kube-proxy` 最多只能比 `kube-apiserver` 落后两个次要版本。
385-
386-
例如:
416+
前提条件:
387417

388-
如果 `kube-proxy` 版本处于 **{{< skew currentVersionAddMinor -2 >}}** 版本:
418+
* 与 kube-proxy 通信的 kube-apiserver 实例的版本是 **{{< skew currentVersion >}}**
419+
可以选择升级 kube-proxy 实例到 **{{< skew currentVersion >}}**
420+
(或者它们可以保持在 **{{< skew currentVersionAddMinor -1 >}}****{{< skew currentVersionAddMinor -2 >}}**
389421

390-
* `kubelet` 必须处于相同的次要版本 **{{< skew currentVersionAddMinor -2 >}}**
391-
* `kube-apiserver` 版本必须介于 **{{< skew currentVersionAddMinor -2 >}}****{{< skew currentVersion >}}** 之间,包括两者。
422+
{{< warning >}}
423+
<!--
424+
Running a cluster with `kube-proxy` instances that are persistently two minor versions behind `kube-apiserver` means they must be upgraded before the control plane can be upgraded.
425+
-->
426+
在一个集群中运行持续比 `kube-apiserver` 落后两个次版本的 `kube-proxy` 实例意味着在升级控制平面之前必须先升级它们。
427+
{{</ warning >}}

0 commit comments

Comments
 (0)