diff --git a/content/zh-cn/releases/version-skew-policy.md b/content/zh-cn/releases/version-skew-policy.md index 718998dddf..7c97444269 100644 --- a/content/zh-cn/releases/version-skew-policy.md +++ b/content/zh-cn/releases/version-skew-policy.md @@ -34,7 +34,7 @@ Specific cluster deployment tools may place additional restrictions on version s Kubernetes versions are expressed as **x.y.z**, where **x** is the major version, **y** is the minor version, and **z** is the patch version, following [Semantic Versioning](https://semver.org/) terminology. For more information, see [Kubernetes Release Versioning](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/release/versioning.md#kubernetes-release-versioning). -The Kubernetes project maintains release branches for the most recent three minor releases ({{< skew latestVersion >}}, {{< skew prevMinorVersion >}}, {{< skew oldestMinorVersion >}}). Kubernetes 1.19 and newer receive approximately 1 year of patch support. Kubernetes 1.18 and older received approximately 9 months of patch support. +The Kubernetes project maintains release branches for the most recent three minor releases ({{< skew currentVersion >}}, {{< skew currentVersionAddMinor -1 >}}, {{< skew currentVersionAddMinor -2 >}}). Kubernetes 1.19 and newer receive approximately 1 year of patch support. Kubernetes 1.18 and older received approximately 9 months of patch support. --> ## 支持的版本 {#supported-versions} @@ -43,7 +43,7 @@ Kubernetes 版本以 **x.y.z** 表示,其中 **x** 是主要版本, 更多信息请参见 [Kubernetes 版本发布控制](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/release/versioning.md#kubernetes-release-versioning)。 -Kubernetes 项目维护最近的三个次要版本({{< skew latestVersion >}}、{{< skew prevMinorVersion >}}、{{< skew oldMinorVersion >}})的发布分支。 +Kubernetes 项目维护最近的三个次要版本({{< skew currentVersion >}}、{{< skew currentVersionAddMinor -1 >}}、{{< skew oldMinorVersion >}})的发布分支。 Kubernetes 1.19 和更新的版本获得大约 1 年的补丁支持。 Kubernetes 1.18 及更早的版本获得了大约 9 个月的补丁支持。 @@ -71,8 +71,8 @@ In [highly-available (HA) clusters](/docs/setup/production-environment/tools/kub Example: -* newest `kube-apiserver` is at **{{< skew latestVersion >}}** -* other `kube-apiserver` instances are supported at **{{< skew latestVersion >}}** and **{{< skew prevMinorVersion >}}** +* newest `kube-apiserver` is at **{{< skew currentVersion >}}** +* other `kube-apiserver` instances are supported at **{{< skew currentVersion >}}** and **{{< skew currentVersionAddMinor -1 >}}** --> ## 支持的版本偏差 {#supported-version-skew} @@ -83,8 +83,8 @@ Example: 例如: -* 最新的 `kube-apiserver` 实例处于 **{{< skew latestVersion >}}** 版本 -* 其他 `kube-apiserver` 实例支持 **{{< skew latestVersion >}}** 和 **{{< skew prevMinorVersion >}}** 版本 +* 最新的 `kube-apiserver` 实例处于 **{{< skew currentVersion >}}** 版本 +* 其他 `kube-apiserver` 实例支持 **{{< skew currentVersion >}}** 和 **{{< skew currentVersionAddMinor -1 >}}** 版本 ### kubelet {#kubelet} @@ -102,8 +102,8 @@ Example: 例如: -* `kube-apiserver` 处于 **{{< skew latestVersion >}}** 版本 -* `kubelet` 支持 **{{< skew latestVersion >}}**、**{{< skew prevMinorVersion >}}** 和 **{{< skew oldMinorVersion >}}** 版本 +* `kube-apiserver` 处于 **{{< skew currentVersion >}}** 版本 +* `kubelet` 支持 **{{< skew currentVersion >}}**、**{{< skew currentVersionAddMinor -1 >}}** 和 **{{< skew oldMinorVersion >}}** 版本 {{< note >}} 例如: -* `kube-apiserver` 实例处于 **{{< skew latestVersion >}}** 和 **{{< skew prevMinorVersion >}}** 版本 -* `kubelet` 支持 **{{< skew prevMinorVersion >}}** 和 **{{< skew oldMinorVersion >}}** 版本, - (不支持 **{{< skew latestVersion >}}** 版本,因为这将比 - `kube-apiserver` **{{< skew prevMinorVersion >}}** 版本的实例新) +* `kube-apiserver` 实例处于 **{{< skew currentVersion >}}** 和 **{{< skew currentVersionAddMinor -1 >}}** 版本 +* `kubelet` 支持 **{{< skew currentVersionAddMinor -1 >}}** 和 **{{< skew oldMinorVersion >}}** 版本, + (不支持 **{{< skew currentVersion >}}** 版本,因为这将比 + `kube-apiserver` **{{< skew currentVersionAddMinor -1 >}}** 版本的实例新) ### kube-controller-manager、kube-scheduler 和 cloud-controller-manager {#kube-controller-manager-kube-scheduler-and-cloud-controller-manager} @@ -143,9 +143,9 @@ Example: 例如: -* `kube-apiserver` 处于 **{{< skew latestVersion >}}** 版本 +* `kube-apiserver` 处于 **{{< skew currentVersion >}}** 版本 * `kube-controller-manager`、`kube-scheduler` 和 `cloud-controller-manager` - 支持 **{{< skew latestVersion >}}** 和 **{{< skew prevMinorVersion >}}** 版本 + 支持 **{{< skew currentVersion >}}** 和 **{{< skew currentVersionAddMinor -1 >}}** 版本 {{< note >}} 例如: * `kube-apiserver` 实例处于 - **{{< skew latestVersion >}}** 和 **{{< skew prevMinorVersion >}}** 版本 + **{{< skew currentVersion >}}** 和 **{{< skew currentVersionAddMinor -1 >}}** 版本 * `kube-controller-manager`、`kube-scheduler` 和 `cloud-controller-manager` 与可以路由到任何 `kube-apiserver` 实例的负载均衡器通信 * `kube-controller-manager`、`kube-scheduler` 和 `cloud-controller-manager` - 支持 **{{< skew prevMinorVersion >}}** 版本(不支持 **{{< skew latestVersion >}}** - 版本,因为它比 **{{< skew prevMinorVersion >}}** 版本的 `kube-apiserver` 实例新) + 支持 **{{< skew currentVersionAddMinor -1 >}}** 版本(不支持 **{{< skew currentVersion >}}** + 版本,因为它比 **{{< skew currentVersionAddMinor -1 >}}** 版本的 `kube-apiserver` 实例新) ### kubectl {#kubectl} @@ -189,9 +189,9 @@ Example: 例如: -* `kube-apiserver` 处于 **{{< skew latestVersion >}}** 版本 -* `kubectl` 支持 **{{< skew nextMinorVersion >}}**、**{{< skew latestVersion >}}** - 和 **{{< skew prevMinorVersion >}}** 版本 +* `kube-apiserver` 处于 **{{< skew currentVersion >}}** 版本 +* `kubectl` 支持 **{{< skew nextMinorVersion >}}**、**{{< skew currentVersion >}}** + 和 **{{< skew currentVersionAddMinor -1 >}}** 版本 {{< note >}} 例如: * `kube-apiserver` 实例处于 - **{{< skew latestVersion >}}** 和 **{{< skew prevMinorVersion >}}** 版本 -* `kubectl` 支持 **{{< skew latestVersion >}}** 和 **{{< skew prevMinorVersion >}}** + **{{< skew currentVersion >}}** 和 **{{< skew currentVersionAddMinor -1 >}}** 版本 +* `kubectl` 支持 **{{< skew currentVersion >}}** 和 **{{< skew currentVersionAddMinor -1 >}}** 版本(其他版本将与 `kube-apiserver` 组件之一相差不止一个的次要版本) ## 支持的组件升级顺序 {#supported-component-upgrade-order} 组件之间支持的版本偏差会影响必须升级组件的顺序。 -本节介绍了将现有集群从 **{{< skew prevMinorVersion >}}** -版本转换到 **{{< skew latestVersion >}}** 版本时必须升级组件的顺序。 +本节介绍了将现有集群从 **{{< skew currentVersionAddMinor -1 >}}** +版本转换到 **{{< skew currentVersion >}}** 版本时必须升级组件的顺序。 ### kube-apiserver {#kube-apiserver-1} 先决条件: -* 在单实例集群中,现有的 `kube-apiserver` 实例处于 **{{< skew prevMinorVersion >}}** 版本 +* 在单实例集群中,现有的 `kube-apiserver` 实例处于 **{{< skew currentVersionAddMinor -1 >}}** 版本 * 在 HA 集群中,所有 `kube-apiserver` 实例都处于 - **{{< skew prevMinorVersion >}}** 或 **{{< skew latestVersion >}}** 版本 + **{{< skew currentVersionAddMinor -1 >}}** 或 **{{< skew currentVersion >}}** 版本 (这确保了最老和最新的 `kube-apiserver` 实例之间的 1 个次要版本的最大偏差) * 与此服务器通信的 `kube-controller-manager`、`kube-scheduler` 和 `cloud-controller-manager` - 实例的版本为 **{{< skew prevMinorVersion >}}** + 实例的版本为 **{{< skew currentVersionAddMinor -1 >}}** (这确保它们是不比现有 API 服务器版本还要新,并且在新 API 服务器版本的 1 个次要版本内) * 所有节点上的 `kubelet` 实例都是 - **{{< skew prevMinorVersion >}}** 或 **{{< skew oldMinorVersion >}}** + **{{< skew currentVersionAddMinor -1 >}}** 或 **{{< skew oldMinorVersion >}}** 版本(这确保它们不比现有 API 服务器版本新,并且在新 API 服务器版本的 2 个次要版本内) * 已注册的 admission webhook 能够处理新的 `kube-apiserver` 实例将发送给他们的数据: * `ValidatingWebhookConfiguration` 和 `MutatingWebhookConfiguration` - 对象已更新以包含 **{{< skew latestVersion >}}** 中添加的任何新版本的 REST 资源 + 对象已更新以包含 **{{< skew currentVersion >}}** 中添加的任何新版本的 REST 资源 (或使用 v1.15+ 中可用的 [`matchPolicy: Equivalent` 选项](/zh/docs/reference/access-authn-authz/extensible-admission-controllers/#matching-requests-matchpolicy)) * webhook 能够处理将发送给它们的任何新版本的 REST 资源, - 以及添加到 **{{< skew latestVersion >}}** 中现有版本的任何新字段 + 以及添加到 **{{< skew currentVersion >}}** 中现有版本的任何新字段 -将 `kube-apiserver` 升级到 **{{< skew latestVersion >}}** 版本 +将 `kube-apiserver` 升级到 **{{< skew currentVersion >}}** 版本 {{< note >}} ### kube-controller-manager、kube-scheduler 和 cloud-controller-manager {#kube-controller-manager-kube-scheduler-and-cloud-controller-manager-1} 先决条件: -* 与这些组件通信的 `kube-apiserver` 实例处于 **{{< skew latestVersion >}}** 版本 +* 与这些组件通信的 `kube-apiserver` 实例处于 **{{< skew currentVersion >}}** 版本 (在 HA 集群中,这些控制平面组件可以与集群中的任何 `kube-apiserver` 实例通信, 所有 `kube-apiserver` 实例必须在升级这些组件之前升级) 将 `kube-controller-manager`、`kube-scheduler` 和 `cloud-controller-manager` -升级到 **{{< skew latestVersion >}}** 版本 +升级到 **{{< skew currentVersion >}}** 版本 ### kubelet {#kubelet-1} 先决条件: -* 与 `kubelet` 通信的 `kube-apiserver` 实例处于 **{{< skew latestVersion >}}** 版本 +* 与 `kubelet` 通信的 `kube-apiserver` 实例处于 **{{< skew currentVersion >}}** 版本 可选择将 `kubelet` 实例升级到 **{{< skew latestMinorVersion >}}** 版本 -(或者它们可以留在 **{{< skew prevMinorVersion >}}** 或 **{{< skew oldMinorVersion >}}** 版本) +(或者它们可以留在 **{{< skew currentVersionAddMinor -1 >}}** 或 **{{< skew oldMinorVersion >}}** 版本) {{< note >}} ### kube-proxy {#kube-proxy} @@ -360,4 +360,4 @@ If `kube-proxy` version is **{{< skew oldestMinorVersion >}}**: 如果 `kube-proxy` 版本处于 **{{< skew oldMinorVersion >}}** 版本: * `kubelet` 必须处于相同的次要版本 **{{< skew oldMinorVersion >}}**。 -* `kube-apiserver` 版本必须介于 **{{< skew oldMinorVersion >}}** 和 **{{< skew latestVersion >}}** 之间,包括两者。 +* `kube-apiserver` 版本必须介于 **{{< skew oldMinorVersion >}}** 和 **{{< skew currentVersion >}}** 之间,包括两者。