From 52e853bf1ecef08bd37063a2e05a9cc4b73526f3 Mon Sep 17 00:00:00 2001 From: Michael Date: Sat, 20 Aug 2022 06:52:53 +0800 Subject: [PATCH] [zh-cn] resync 2022-04-07-Kubernetes-1-24-removals-and-deprecations.md --- ...bernetes-1-24-removals-and-deprecations.md | 112 +++++++++--------- 1 file changed, 54 insertions(+), 58 deletions(-) diff --git a/content/zh-cn/blog/_posts/2022-04-07-Kubernetes-1-24-removals-and-deprecations.md b/content/zh-cn/blog/_posts/2022-04-07-Kubernetes-1-24-removals-and-deprecations.md index e1a3e8629b..1d164b945f 100644 --- a/content/zh-cn/blog/_posts/2022-04-07-Kubernetes-1-24-removals-and-deprecations.md +++ b/content/zh-cn/blog/_posts/2022-04-07-Kubernetes-1-24-removals-and-deprecations.md @@ -1,6 +1,6 @@ --- layout: blog -title: "Kubernetes 1.24 的删除和弃用" +title: "Kubernetes 1.24 中的移除和弃用" date: 2022-04-07 slug: upcoming-changes-in-kubernetes-1-24 --- @@ -19,9 +19,9 @@ As Kubernetes evolves, features and APIs are regularly revisited and removed. Ne an alternative or improved approach to solving existing problems, motivating the team to remove the old approach. --> -**作者**： Mickey Boxell (Oracle) +**作者**：Mickey Boxell (Oracle) -随着 Kubernetes 的发展，特性和 API 会定期被重新访问和删除。 +随着 Kubernetes 的发展，一些特性和 API 会被定期重检和移除。 新特性可能会提供替代或改进的方法，来解决现有的问题，从而激励团队移除旧的方法。 -我们希望确保你了解 Kubernetes 1.24 版本的变化。 该版本将 **弃用** 一些（测试版/beta）API， -转而支持相同 API 的稳定版本。 Kubernetes 1.24 版本的主要变化是 -[移除 Dockershim](https://github.com/kubernetes/enhancements/tree/master/keps/sig-node/2221-remove-dockershim)。 +我们希望确保你了解 Kubernetes 1.24 版本的变化。该版本将 **弃用** 一些（测试版/beta）API， +转而支持相同 API 的稳定版本。Kubernetes 1.24 +版本的主要变化是[移除 Dockershim](https://github.com/kubernetes/enhancements/tree/master/keps/sig-node/2221-remove-dockershim)。 这将在下面讨论，并将在发布时更深入地探讨。 要提前了解 Kubernetes 1.24 中的更改，请查看正在更新中的 [CHANGELOG](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.24.md)。 @@ -52,13 +52,13 @@ finally be removed. --> ## 关于 Dockershim {#a-note-about-dockershim} -可以肯定地说，随着 Kubernetes 1.24 的发布，最受关注的删除是 Dockershim。 -Dockershim 在 1.20 版本中已被弃用。 如 +可以肯定地说，随着 Kubernetes 1.24 的发布，最受关注的是移除 Dockershim。 +Dockershim 在 1.20 版本中已被弃用。如 [Kubernetes 1.20 变更日志](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.20.md#deprecation)中所述： "Docker support in the kubelet is now deprecated and will be removed in a future release. The kubelet uses a module called "dockershim" which implements CRI support for Docker and it has seen maintenance issues in the Kubernetes community." -随着即将发布的 Kubernetes 1.24，Dockershim 将最终被删除。 +随着即将发布的 Kubernetes 1.24，Dockershim 将最终被移除。 有关 Kubernetes 为何不再使用 dockershim 的更多信息， -请参见：[Kubernetes 正在离开 Dockershim](/blog/2022/01/07/kubernetes-is-moving-on-from-dockershim/) +请参见：[Kubernetes 即将移除 Dockershim](/zh-cn/blog/2022/01/07/kubernetes-is-moving-on-from-dockershim/) 和[最新的弃用 Dockershim 的常见问题](/zh-cn/blog/2022/02/17/dockershim-faq/)。 -查看[你的集群准备好使用 v1.24 了吗？](/blog/2022/03/31/ready-for-dockershim-removal/) 一文， +查看[你的集群准备好使用 v1.24 版本了吗？](/zh-cn/blog/2022/03/31/ready-for-dockershim-removal/) 一文， 了解如何确保你的集群在从 1.23 版本升级到 1.24 版本后继续工作。 -## Kubernetes API 删除和弃用流程 {#the-Kubernetes-api-removal-and-deprecation-process} +## Kubernetes API 移除和弃用流程 {#the-Kubernetes-api-removal-and-deprecation-process} -Kubernetes 包含大量随时间演变的组件。在某些情况下，这种演变会导致 API、标志或整个特性被删除。 +Kubernetes 包含大量随时间演变的组件。在某些情况下，这种演变会导致 API、标志或整个特性被移除。 为了防止用户面对重大变化，Kubernetes 贡献者采用了一项特性[弃用策略](/zh-cn/docs/reference/using-api/deprecation-policy/)。 -此策略确保仅当同一 API 的较新稳定版本可用并且 +此策略确保仅当同一 API 的较新稳定版本可用并且 API 具有以下稳定性级别所指示的最短生命周期时，才可能弃用稳定版本 API： -* 正式发布 (GA) 或稳定的 API 版本可能被标记为已弃用，但不得在 Kubernetes 的主版本中删除。 +* 正式发布 (GA) 或稳定的 API 版本可能被标记为已弃用，但不得在 Kubernetes 的主版本中移除。 * 测试版（beta）或预发布 API 版本在弃用后必须支持 3 个版本。 -* Alpha 或实验性 API 版本可能会在任何版本中被删除，恕不另行通知。 +* Alpha 或实验性 API 版本可能会在任何版本中被移除，恕不另行通知。 -删除遵循相同的弃用政策，无论 API 是由于 测试版（beta）功能逐渐稳定还是因为该 -API 未被证明是成功的而被删除。 -Kubernetes 将继续确保在删除 API 时提供用来迁移的文档。 +移除遵循相同的弃用政策，无论 API 是由于 测试版（beta）功能逐渐稳定还是因为该 +API 未被证明是成功的而被移除。 +Kubernetes 将继续确保在移除 API 时提供用来迁移的文档。 -**弃用的** API 是指那些已标记为在未来 Kubernetes 版本中被删除的 API。 -**删除的** API 是指那些在被弃用后不再可用于当前受支持的 Kubernetes 版本的 API。 -这些删除已被更新的、稳定的/普遍可用的 (GA) API 所取代。 +**弃用的** API 是指那些已标记为在未来 Kubernetes 版本中移除的 API。 +**移除的** API 是指那些在被弃用后不再可用于当前受支持的 Kubernetes 版本的 API。 +这些移除的 API 已被更新的、稳定的/普遍可用的 (GA) API 所取代。 -## Kubernetes 1.24 的 API 删除、弃用和其他更改 {#api-removals-deprecations-and-other-changes-for-kubernetes-1.24} +## Kubernetes 1.24 的 API 移除、弃用和其他更改 {#api-removals-deprecations-and-other-changes-for-kubernetes-1.24} * [动态 kubelet 配置](https://github.com/kubernetes/enhancements/issues/281): `DynamicKubeletConfig` 用于启用 kubelet 的动态配置。Kubernetes 1.22 中弃用 `DynamicKubeletConfig` 标志。 - 在 1.24 版本中，此特性门控将从 kubelet 中移除。请参阅[重新配置 kubelet](/docs/tasks/administer-cluster/reconfigure-kubelet/)。 - 更多详细信息，请参阅[“删除动态 kubelet 配置” 的 KEP](https://github.com/kubernetes/enhancements/issues/281)。 + 在 1.24 版本中，此特性门控将从 kubelet 中移除。请参阅[重新配置 kubelet](/zh-cn/docs/tasks/administer-cluster/reconfigure-kubelet/)。 + 更多详细信息，请参阅[“移除动态 kubelet 配置” 的 KEP](https://github.com/kubernetes/enhancements/issues/281)。 * [动态日志清洗](https://github.com/kubernetes/kubernetes/pull/107207)：实验性的动态日志清洗功能已被弃用， - 将在 1.24 版本中被删除。该功能引入了一个日志过滤器，可以应用于所有 Kubernetes 系统组件的日志， + 将在 1.24 版本中被移除。该功能引入了一个日志过滤器，可以应用于所有 Kubernetes 系统组件的日志， 以防止各种类型的敏感信息通过日志泄漏。有关更多信息和替代方法，请参阅 [KEP-1753: Kubernetes 系统组件日志清洗](https://github.com/kubernetes/enhancements/tree/master/keps/sig-instrumentation/1753-logs-sanitization#deprecation)。 -* 树内驱动（In-tree provisioner）向 CSI 卷迁移：这适用于许多树内插件， - 包括 [Portworx](https://github.com/kubernetes/enhancements/issues/2589)。 - 参见[树内存储插件向 CSI 卷迁移的设计文档](https://github.com/kubernetes/design-proposals-archive/blob/main/storage/csi-migration.md#background-and-motivations) - 了解更多信息。 - * [从 kubelet 中移除 Dockershim](https://github.com/kubernetes/enhancements/issues/2221)：Docker - 的容器运行时接口(CRI)（即 Dockershim）目前是 kubelet 代码中内置的容器运行时。 它在 1.20 版本中已被弃用。 - 从 1.24 版本开始，kubelet 已经移除 dockershim。 查看这篇博客， + 的容器运行时接口(CRI)（即 Dockershim）目前是 kubelet 代码中内置的容器运行时。它在 1.20 版本中已被弃用。 + 从 1.24 版本开始，kubelet 已经移除 dockershim。查看这篇博客， [了解你需要为 1.24 版本做些什么](/blog/2022/03/31/ready-for-dockershim-removal/)。 -* [pod 调度的存储容量追踪](https://github.com/kubernetes/enhancements/issues/1472)：CSIStorageCapacity API - 支持通过 CSIStorageCapacity 对象暴露当前可用的存储容量，并增强了使用带有延迟绑定的 CSI 卷的 Pod 的调度。 - CSIStorageCapacity API 自 1.24 版本起提供稳定版本。升级到稳定版的 API 将弃用 v1beta1 CSIStorageCapacity API。 +* [Pod 调度的存储容量追踪](https://github.com/kubernetes/enhancements/issues/1472)：CSIStorageCapacity API + 支持通过 CSIStorageCapacity 对象暴露当前可用的存储容量，并增强了使用带有延迟绑定的 CSI 卷的 Pod 的调度。 + CSIStorageCapacity API 自 1.24 版本起提供稳定版本。升级到稳定版的 API 将弃用 v1beta1 CSIStorageCapacity API。 更多信息请参见 [Pod 调度存储容量约束 KEP](https://github.com/kubernetes/enhancements/tree/master/keps/sig-storage/1472-storage-capacity-tracking)。 -* [kubeadm 控制面节点上不再存在 `master` 标签](https://github.com/kubernetes/kubernetes/pull/107533)。 +* [kubeadm 控制面节点上不再存在 `master` 标签](https://github.com/kubernetes/kubernetes/pull/107533)。 对于新集群，控制平面节点将不再添加 'node-role.kubernetes.io/master' 标签， 只会添加 'node-role.kubernetes.io/control-plane' 标签。更多信息请参考 [KEP-2067：重命名 kubeadm “master” 标签和污点](https://github.com/kubernetes/enhancements/tree/master/keps/sig-cluster-lifecycle/kubeadm/2067-rename-master-label-taint)。 -* [VolumeSnapshot v1beta1 CRD 在 1.24 版本中将被移除](https://github.com/kubernetes/enhancements/issues/177)。 +* [VolumeSnapshot v1beta1 CRD 在 1.24 版本中将被移除](https://github.com/kubernetes/enhancements/issues/177)。 Kubernetes 和 [Container Storage Interface](https://github.com/container-storage-interface/spec/blob/master/spec.md) (CSI) 的卷快照和恢复功能，在 1.20 版本中进入测试版。该功能提供标准化 API 设计 (CRD ) 并为 CSI 卷驱动程序添加了 PV 快照/恢复支持， VolumeSnapshot v1beta1 在 1.21 版本中已被弃用，现在不受支持。更多信息请参考 @@ -211,11 +204,12 @@ Docker Engine dependencies. Before upgrading to v1.24, you decide to either rema --> ## 需要做什么 {#what-to-do} -### 删除 Dockershim {#dockershim-removal} +### 移除 Dockershim {#dockershim-removal} + 如前所述，有一些关于从 [dockershim 迁移](/zh-cn/docs/tasks/administer-cluster/migrating-from-dockershim/)的指南。 你可以[从查明节点上所使用的容器运行时](/zh-cn/docs/tasks/administer-cluster/migrating-from-dockershim/find-out-runtime-you-use/)开始。 如果你的节点使用 dockershim，则还有其他可能的 Docker Engine 依赖项， -例如 Pod 或执行 Docker 命令的第三方工具或 Docker 配置文件中的私有注册表。 +例如 Pod 或执行 Docker 命令的第三方工具或 Docker 配置文件中的私有镜像库。 你可以按照[检查移除 Dockershim 是否对你有影响](/zh-cn/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-removal-affects-you/) 的指南来查看可能的 Docker 引擎依赖项。在升级到 1.24 版本之前，你决定要么继续使用 Docker Engine 并 [将 Docker Engine 节点从 dockershim 迁移到 cri-dockerd](/zh-cn/docs/tasks/administer-cluster/migrating-from-dockershim/migrate-dockershim-dockerd/)， @@ -235,9 +229,9 @@ documentation to download and install the `kubectl-convert` binary. kubectl 的 [`kubectl convert`](/zh-cn/docs/tasks/tools/included/kubectl-convert-overview/) 插件有助于解决弃用 API 的迁移问题。该插件方便了不同 API 版本之间清单的转换， -例如，从弃用的 API 版本到非弃用的 API 版本。关于 API 迁移过程的更多信息可以在 -[已弃用 API 的迁移指南](/docs/reference/using-api/deprecation-guide/)中找到。按照 -[安装 `kubectl convert` 插件](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/#install-kubectl-convert-plugin) +例如，从弃用的 API 版本到非弃用的 API 版本。 +关于 API 迁移过程的更多信息可以在[已弃用 API 的迁移指南](/zh-cn/docs/reference/using-api/deprecation-guide/)中找到。 +按照[安装 `kubectl convert` 插件](/zh-cn/docs/tasks/tools/install-kubectl-linux/#install-kubectl-convert-plugin) 文档下载并安装 `kubectl-convert` 二进制文件。 [Kubernetes 1.25 计划移除的 API 的官方列表](/zh-cn/docs/reference/using-api/deprecation-guide/#v1-25)是： -* The beta CronJob API (batch/v1beta1) -* The beta EndpointSlice API (discovery.k8s.io/v1beta1) -* The beta Event API (events.k8s.io/v1beta1) -* The beta HorizontalPodAutoscaler API (autoscaling/v2beta1) -* The beta PodDisruptionBudget API (policy/v1beta1) -* The beta PodSecurityPolicy API (policy/v1beta1) -* The beta RuntimeClass API (node.k8s.io/v1beta1) +* Beta CronJob API (batch/v1beta1) +* Beta EndpointSlice API (discovery.k8s.io/v1beta1) +* Beta Event API (events.k8s.io/v1beta1) +* Beta HorizontalPodAutoscaler API (autoscaling/v2beta1) +* Beta PodDisruptionBudget API (policy/v1beta1) +* Beta PodSecurityPolicy API (policy/v1beta1) +* Beta RuntimeClass API (node.k8s.io/v1beta1) -[Kubernetes 1.25 计划移除的 API 的官方列表](/zh-cn/docs/reference/using-api/deprecation-guide/#v1-25)是： +[Kubernetes 1.26 计划移除的 API 的官方列表](/zh-cn/docs/reference/using-api/deprecation-guide/#v1-26)是： -* The beta FlowSchema 和 PriorityLevelConfiguration API (flowcontrol.apiserver.k8s.io/v1beta1) -* The beta HorizontalPodAutoscaler API (autoscaling/v2beta2) +* Beta FlowSchema 和 PriorityLevelConfiguration API (flowcontrol.apiserver.k8s.io/v1beta1) +* Beta HorizontalPodAutoscaler API (autoscaling/v2beta2) +--> ### 了解更多 {#want-to-know-more} + Kubernetes 发行说明中宣告了弃用信息。你可以在以下版本的发行说明中看到待弃用的公告： + * [Kubernetes 1.21](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.21.md#deprecation) * [Kubernetes 1.22](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.22.md#deprecation) * [Kubernetes 1.23](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.23.md#deprecation) * 我们将正式宣布 [Kubernetes 1.24](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.24.md#deprecation) 的弃用信息， 作为该版本 CHANGELOG 的一部分。 -有关弃用和删除过程的信息，请查看 Kubernetes 官方[弃用策略](/zh-cn/docs/reference/using-api/deprecation-policy/#deprecating-parts-of-the-api) 文档。 +有关弃用和移除过程的信息，请查看 Kubernetes 官方[弃用策略](/zh-cn/docs/reference/using-api/deprecation-policy/#deprecating-parts-of-the-api)文档。