From e5d5f82c72421c400620b090c9925d9c056e2636 Mon Sep 17 00:00:00 2001 From: chenxuc Date: Mon, 30 Aug 2021 09:12:11 +0800 Subject: [PATCH] [zh]sync admin task files --- .../administer-cluster/access-cluster-api.md | 8 +-- .../controller-manager-leader-migration.md | 51 ++++++++++++------- .../cpu-management-policies.md | 38 +++++++++++++- .../limit-storage-consumption.md | 4 +- 4 files changed, 76 insertions(+), 25 deletions(-) diff --git a/content/zh/docs/tasks/administer-cluster/access-cluster-api.md b/content/zh/docs/tasks/administer-cluster/access-cluster-api.md index 4f2ee3b05a..7b1c9bed98 100644 --- a/content/zh/docs/tasks/administer-cluster/access-cluster-api.md +++ b/content/zh/docs/tasks/administer-cluster/access-cluster-api.md @@ -55,11 +55,11 @@ kubectl config view ``` -许多[样例](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/) +许多[样例](https://github.com/kubernetes/examples/tree/master/) 提供了使用 kubectl 的介绍。完整文档请见 [kubectl 手册](/zh/docs/reference/kubectl/overview/)。 如果该应用程序部署为集群中的一个 -Pod，请参阅[下一节](#accessing-the-api-from-within-accessing-the-api-from-within-a-pod)。 +Pod，请参阅[从 Pod 内访问 API](/zh/docs/tasks/access-application-cluster/access-cluster/#accessing-the-api-from-a-pod)。 #### Python 客户端 {#python-client} diff --git a/content/zh/docs/tasks/administer-cluster/controller-manager-leader-migration.md b/content/zh/docs/tasks/administer-cluster/controller-manager-leader-migration.md index f8ed2cdb4a..83a716ce44 100644 --- a/content/zh/docs/tasks/administer-cluster/controller-manager-leader-migration.md +++ b/content/zh/docs/tasks/administer-cluster/controller-manager-leader-migration.md @@ -17,7 +17,7 @@ content_type: task -{{< feature-state state="alpha" for_k8s_version="v1.21" >}} +{{< feature-state state="beta" for_k8s_version="v1.22" >}} {{< glossary_definition term_id="cloud-controller-manager" length="all" prepend="云管理控制器是">}} @@ -43,17 +43,14 @@ For a single-node control plane, or if unavailability of controller managers can 对于单节点控制平面，或者在升级过程中可以容忍控制器管理器不可用的情况，则不需要领导者迁移，并且可以忽略本指南。 -领导者迁移是一项 Alpha 阶段功能，默认情况下处于禁用状态，它需要设置控制器管理器的 `--enable-leader-migration` 参数。 -可以通过在 `kube-controller-manager` 或 `cloud-controller-manager` 上设置特性门控 -`ControllerManagerLeaderMigration` 和 `--enable-leader-migration` 来启用。 +领导者迁移可以通过在 `kube-controller-manager` 或 `cloud-controller-manager` 上设置 `--enable-leader-migration` 来启用。 领导者迁移仅在升级期间适用，并且可以安全地禁用，也可以在升级完成后保持启用状态。 本指南将引导你手动将控制平面从内置的云驱动的 `kube-controller-manager` 升级为 @@ -64,14 +61,14 @@ If you use a tool to administrator the cluster, please refer to the documentatio 假定控制平面正在运行 Kubernetes N 版本，并且要升级到 N+1 版本。 -尽管可以在同一版本中进行迁移，但理想情况下，迁移应作为升级的一部分执行，以便可以更改配置与发布保持一致。 +尽管可以在同一版本中进行迁移，但理想情况下，迁移应作为升级的一部分执行，以便可以更改配置与每个发布版本保持一致。 N 和 N+1的确切版本取决于各个云驱动。例如，如果云驱动构建了一个可与 Kubernetes 1.22 配合使用的 `cloud-controller-manager`， 则 N 可以为 1.21，N+1 可以为 1.22。 @@ -80,19 +77,21 @@ N 和 N+1的确切版本取决于各个云驱动。例如，如果云驱动构 树外云驱动必须已经构建了一个实现领导者迁移的 `cloud-controller-manager`。 如果云驱动导入了 v0.21.0 或更高版本的 `k8s.io/cloud-provider` 和 `k8s.io/controller-manager`， 则可以进行领导者迁移。 +但是，对 v0.22.0 以下的版本，领导者迁移是一项 Alpha 阶段功能，它需要启用特性门控 `ControllerManagerLeaderMigration`。 本指南假定每个控制平面节点的 kubelet 以静态 pod 的形式启动 `kube-controller-manager` 和 `cloud-controller-manager`，静态 pod 的定义在清单文件中。 @@ -137,19 +136,21 @@ Do the same to the `system::leader-locking-cloud-controller-manager` role. ### 初始领导者迁移配置 -领导者迁移需要一个表示控制器到管理器分配状态的配置文件。 +领导者迁移可以选择使用一个表示控制器到管理器分配状态的配置文件。 目前，对于树内云驱动，`kube-controller-manager` 运行 `route`、`service` 和 `cloud-node-lifecycle`。 以下示例配置显示了分配。 +领导者迁移可以不指定配置来启用。请参阅 [默认配置](#default-configuration) 以获取更多详细信息。 + ```yaml kind: LeaderMigrationConfiguration -apiVersion: controllermanager.config.k8s.io/v1alpha1 +apiVersion: controllermanager.config.k8s.io/v1beta1 leaderName: cloud-provider-extraction-migration resourceLock: leases controllerLeaders: @@ -166,7 +167,6 @@ On each control plane node, save the content to `/etc/leadermigration.conf`, and update the manifest of `kube-controller-manager` so that the file is mounted inside the container at the same location. Also, update the same manifest to add the following arguments: -- `--feature-gates=ControllerManagerLeaderMigration=true` to enable Leader Migration which is an alpha feature - `--enable-leader-migration` to enable Leader Migration on the controller manager - `--leader-migration-config=/etc/leadermigration.conf` to set configuration file @@ -176,7 +176,6 @@ Restart `kube-controller-manager` on each node. At this moment, `kube-controller 并更新 `kube-controller-manager` 清单，以便将文件安装在容器内的同一位置。 另外，更新相同的清单，添加以下参数： -- `--feature-gates=ControllerManagerLeaderMigration=true` 启用领导者迁移（这是 Alpha 版功能） - `--enable-leader-migration` 在控制器管理器上启用领导者迁移 - `--leader-migration-config=/etc/leadermigration.conf` 设置配置文件 @@ -196,7 +195,7 @@ Please note `component` field of each `controllerLeaders` changing from `kube-co ```yaml kind: LeaderMigrationConfiguration -apiVersion: controllermanager.config.k8s.io/v1alpha1 +apiVersion: controllermanager.config.k8s.io/v1beta1 leaderName: cloud-provider-extraction-migration resourceLock: leases controllerLeaders: @@ -286,6 +285,22 @@ To re-enable Leader Migration, recreate the configuration file and add its mount 最后删除 `/etc/leadermigration.conf`。 要重新启用领导者迁移，请重新创建配置文件，并将其挂载和启用领导者迁移的标志添加回到 `cloud-controller-manager`。 + +### 默认配置 {#default-configuration} + +从 Kubernetes 1.22 开始，领导者迁移提供了一个默认配置，它适用于默认的控制器到管理器分配。 +可以通过设置 `--enable-leader-migration`，但不设置 `--leader-migration-config=` 来启用默认配置。 + +对于 `kube-controller-manager` 和 `cloud-controller-manager`，如果没有用参数来启用树内云驱动或者改变控制器属主， +则可以使用默认配置来避免手动创建配置文件。 + ## {{% heading "whatsnext" %}} +Static 策略的行为可以使用 `--cpu-manager-policy-options` 参数来微调。 +该参数采用一个逗号分隔的 `key=value` 策略选项列表。 + ### none 策略 `none` 策略显式地启用现有的默认 CPU 亲和方案，不提供操作系统调度器默认行为之外的亲和性策略。 通过 CFS 配额来实现 [Guaranteed pods](/zh/docs/tasks/configure-pod-container/quality-service-pod/) +和 [Burstable pods](/zh/docs/tasks/configure-pod-container/quality-service-pod/) 的 CPU 使用限制。 +#### Static 策略选项 + +如果使用 `full-pcpus-only` 策略选项，static 策略总是会分配完整的物理核心。 +你可以通过在 CPUManager 策略选项里加上 `full-pcups-only=true` 来启用该选项。 + +默认情况下，如果不使用该选项，static 策略会使用拓扑感知最适合的分配方法来分配 CPU。 +在启用了 SMT 的系统上，此策略所分配是与硬件线程对应的、独立的虚拟核。 +这会导致不同的容器共享相同的物理核心，该行为进而会导致 +[吵闹的邻居问题](https://en.wikipedia.org/wiki/Cloud_computing_issues#Performance_interference_and_noisy_neighbors)。 + +启用该选项之后，只有当一个 Pod 里所有容器的 CPU 请求都能够分配到完整的物理核心时，kubelet 才会接受该 Pod。 +如果 Pod 没有被准入，它会被置于 Failed 状态，错误消息是 `SMTAlignmentError`。 \ No newline at end of file diff --git a/content/zh/docs/tasks/administer-cluster/limit-storage-consumption.md b/content/zh/docs/tasks/administer-cluster/limit-storage-consumption.md index 8675583807..003b8dc7a4 100644 --- a/content/zh/docs/tasks/administer-cluster/limit-storage-consumption.md +++ b/content/zh/docs/tasks/administer-cluster/limit-storage-consumption.md @@ -10,9 +10,9 @@ content_type: task -此示例演示了一种限制名字空间中存储使用量的简便方法。 +此示例演示了如何限制一个名字空间中的存储使用量。