From 20cbdf25f71985093f77ef1912d9299f85c1a135 Mon Sep 17 00:00:00 2001 From: "xin.li" Date: Sat, 16 Dec 2023 23:13:25 +0800 Subject: [PATCH] [zh-cn] sync kms-provider configure-multiple-schedulers deprecation-guide Signed-off-by: xin.li --- .../reference/using-api/deprecation-guide.md | 46 +++++++++++++++-- .../tasks/administer-cluster/kms-provider.md | 49 ++++--------------- .../configure-multiple-schedulers.md | 9 ++-- 3 files changed, 56 insertions(+), 48 deletions(-) diff --git a/content/zh-cn/docs/reference/using-api/deprecation-guide.md b/content/zh-cn/docs/reference/using-api/deprecation-guide.md index c6a4e4cfdd..ff6cef6e4c 100644 --- a/content/zh-cn/docs/reference/using-api/deprecation-guide.md +++ b/content/zh-cn/docs/reference/using-api/deprecation-guide.md @@ -33,6 +33,36 @@ deprecated API versions to newer and more stable API versions. --> ## 各发行版本中移除的 API {#removed-apis-by-release} +### v1.32 + + +**v1.32** 发行版本将停止提供以下已弃用的 API 版本： + + +#### 流控制资源 {#flowcontrol-resources-v132} + +FlowSchema 和 PriorityLevelConfiguration 的 +**flowcontrol.apiserver.k8s.io/v1beta3** API 版本将不再在 v1.32 中提供。 + + +* 迁移清单和 API 客户端以使用 **flowcontrol.apiserver.k8s.io/v1** API 版本（自 v1.29 起可用）。 +* 所有现有的持久对象都可以通过新的 API 访问。 +* **flowcontrol.apiserver.k8s.io/v1** 中的显着变化： + * PriorityLevelConfiguration 的 `spec.limited.nominalConcurrencyShares` + 字段仅在未指定时默认为 30，并且显式值 0 时不会更改为 30。 + ### v1.29 **flowcontrol.apiserver.k8s.io/v1beta2** API 版本的 FlowSchema 和 PriorityLevelConfiguration 将不会在 v1.29 中提供。 -* 迁移清单和 API 客户端使用 **flowcontrol.apiserver.k8s.io/v1beta3** API 版本， - 此 API 从 v1.26 版本开始可用； +* 迁移清单和 API 客户端使用 **flowcontrol.apiserver.k8s.io/v1** API 版本（自 v1.29 版本开始可用）， + 或 **flowcontrol.apiserver.k8s.io/v1beta3** API 版本（自 v1.26 起可用）； * 所有的已保存的对象都可以通过新的 API 来访问； +* **flowcontrol.apiserver.k8s.io/v1** 中的显着变化： + * PriorityLevelConfiguration 的 `spec.limited.assuredConcurrencyShares` + 字段已被重命名为 `spec.limited.nominalConcurrencyShares`，仅在未指定时默认为 30， + 并且显式值 0 不会更改为 30。 * **flowcontrol.apiserver.k8s.io/v1beta3** 中需要额外注意的变更： * PriorityLevelConfiguration 的 `spec.limited.assuredConcurrencyShares` - 字段已被更名为 `spec.limited.nominalConcurrencyShares` + 字段已被更名为 `spec.limited.nominalConcurrencyShares`。 ### v1.27 diff --git a/content/zh-cn/docs/tasks/administer-cluster/kms-provider.md b/content/zh-cn/docs/tasks/administer-cluster/kms-provider.md index fd3cf53ec0..c409eba5d9 100644 --- a/content/zh-cn/docs/tasks/administer-cluster/kms-provider.md +++ b/content/zh-cn/docs/tasks/administer-cluster/kms-provider.md @@ -179,13 +179,13 @@ KMS v2 does not support the `cachesize` property. All data encryption keys (DEKs the clear once the server has unwrapped them via a call to the KMS. Once cached, DEKs can be used to perform decryption indefinitely without making a call to the KMS. --> -KMS v2 不支持 `cachesize` 属性。一旦服务器通过调用 KMS 解密了数据加密密钥 (DEK)， +KMS v2 不支持 `cachesize` 属性。一旦服务器通过调用 KMS 解密了数据加密密钥（DEK）， 所有的 DEK 将会以明文形式被缓存。一旦被缓存，DEK 可以无限期地用于解密操作，而无需再次调用 KMS。 -参见[理解静态配置加密](/zh-cn/docs/tasks/administer-cluster/encrypt-data) +参见[理解静态配置加密](/zh-cn/docs/tasks/administer-cluster/encrypt-data)。 有关 `EncryptionConfiguration` 格式的更多详细信息，请参阅 -[kube-apiserver 加密 API 参考 (v1)](/zh-cn/docs/reference/config-api/apiserver-encryption.v1/). +[kube-apiserver 加密 API 参考（v1）](/zh-cn/docs/reference/config-api/apiserver-encryption.v1/)。 -## 禁用静态数据加密 {#disabling-encryption-at-rest} - -要禁用静态数据加密： + + -1. 将 `identity` 驱动作为配置文件中的第一个条目： - - ```yaml - apiVersion: apiserver.config.k8s.io/v1 - kind: EncryptionConfiguration - resources: - - resources: - - secrets - providers: - - identity: {} - - kms: - apiVersion: v2 - name : myKmsPlugin - endpoint: unix:///tmp/socketfile.sock - ``` - - -2. 重启所有 `kube-apiserver` 进程。 - -3. 运行下列命令强制重新加密所有 Secret。 - - ```shell - kubectl get secrets --all-namespaces -o json | kubectl replace -f - - ``` +如果你不想再对 Kubernetes API 中保存的数据加密， +请阅读[解密已静态存储的数据](/zh-cn/docs/tasks/administer-cluster/decrypt-data/)。 diff --git a/content/zh-cn/docs/tasks/extend-kubernetes/configure-multiple-schedulers.md b/content/zh-cn/docs/tasks/extend-kubernetes/configure-multiple-schedulers.md index 22896e2338..2fb18c42d2 100644 --- a/content/zh-cn/docs/tasks/extend-kubernetes/configure-multiple-schedulers.md +++ b/content/zh-cn/docs/tasks/extend-kubernetes/configure-multiple-schedulers.md @@ -137,11 +137,10 @@ the `kube-scheduler` during initialization with the `--config` option. The `my-s 在前面提到的调度器配置中，你的调度器呈现为一个 -[KubeSchedulerProfile](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-KubeSchedulerProfile)。 - +[KubeSchedulerProfile](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1/#kubescheduler-config-k8s-io-v1-KubeSchedulerProfile)。 {{< note >}} 请参阅 [kube-scheduler 文档](/zh-cn/docs/reference/command-line-tools-reference/kube-scheduler/) -获取其他命令行参数以及 [Scheduler 配置参考](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1beta3/) +获取其他命令行参数以及 [Scheduler 配置参考](/zh-cn/docs/reference/config-api/kube-scheduler-config.v1/) 获取自定义 `kube-scheduler` 配置的详细说明。