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 new file mode 100644 index 0000000000000..53b20d4b6f61b --- /dev/null +++ b/content/zh/docs/tasks/administer-cluster/controller-manager-leader-migration.md @@ -0,0 +1,278 @@ +--- +title: "使用云管理控制器将复制的控制平面迁移" +linkTitle: "将复制的控制平面迁移以使用云管理控制器" +content_type: task +--- + + + + + +{{< feature-state state="alpha" for_k8s_version="v1.21" >}} + +{{< glossary_definition term_id="cloud-controller-manager" length="all" prepend="云管理控制器是">}} + + +## 背景 +作为 [云提供商提取工作](https://kubernetes.io/blog/2019/04/17/the-future-of-cloud-providers-in-kubernetes/)的一部分, +所有特定于云的控制器都必须移出 `kube-controller-manager`。 +所有在 `kube-controller-manager` 中运行云控制器的现有集群必须迁移到特定于云提供商的 `kube-controller-manager` 中运行控制器。 + +领导者迁移提供了一种机制,其中 HA 集群可以通过两个组件之间的共享资源锁定, +在 `kube-controller-manager` 和 `cloud-controller-manager` 之间安全地迁移 “特定于云” 的控制器,同时升级复制的控制平面。 +对于单节点控制平面,或者在升级过程中可以容忍控制器管理器不可用的情况,则不需要领导者迁移,并且可以忽略本指南。 + +领导者迁移是一项 Alpha 阶段功能,默认情况下处于禁用状态,它需要在控制管理器上设置 `--enable-leader-migration`。 +可以通过在 `kube-controller-manager` 或 `cloud-controller-manager` 上设置功能门 +`ControllerManagerLeaderMigration` 和 `--enable-leader-migration` 来启用。 +领导者迁移仅在升级期间适用,并且可以安全地禁用,也可以在升级完成后保持启用状态。 + +本指南将引导你手动将控制平面从内置云提供程序的 `kube-controller-manager` 升级到同时运行 `kube-controller-manager` 和 `cloud-controller-manager`。 +如果使用工具来管理群集,请参阅该工具和云提供商的文档以获取更多详细信息。 + +## {{% heading "prerequisites" %}} + + +假定控制平面正在运行 Kubernetes N 版本,并且要升级到 N + 1 版本。 +尽管可以在同一版本中进行迁移,但理想情况下,迁移应作为升级的一部分执行,以便可以更改配置与发布保持一致。 +N 和 N +1的确切版本取决于每个云提供商。例如,如果云提供商构建了一个可与 Kubernetes 1.22 配合使用的 `cloud-controller-manager` ,则 N 可以为 1.21,N +1 可以为 1.22。 + +控制平面节点应运行 `kube-controller-manager` ,并通过 `--leader-elect=true` 启用领导者选举。 +从版本 N 开始,In-Tree 云提供商必须设置 `--cloud-provider` 标志,而且 `cloud-controller-manager` 还尚未部署。 + +Out-Of-Tree 云提供商必须已经使用领导者迁移实施构建了一个 `cloud-controller-manager`。 +如果云提供商导入了 v0.21.0 或更高版本的 `k8s.io/cloud-provider` 和 `k8s.io/controller-manager` ,则可以进行领导者迁移。 + +本指南假定每个控制平面节点的 kubelet 以清单形式定义的静态 pod 的形式启动 `kube-controller-manager` 和 `cloud-controller-manager`。 +如果组件以其他设置运行,请相应地调整步骤。 + +为了获得授权,本指南假定集群使用 RBAC。如果另一种授权模式授予 `kube-controller-manager` 和 `cloud-controller-manager` 组件权限, +请以与该模式匹配的方式授予所需的访问权限。 + + + + +### 授予访问迁移租赁的权限 + +控制器管理器的默认权限仅允许访问其主租约。为了使迁移正常进行,需要访问另一个租约。 + +您可以通过修改 `system::leader-locking-kube-controller-manager` 角色来授予 `kube-controller-manager` 完全访问租约API的权限。 +本任务指南假定迁移租约的名称为 `cloud-provider-extraction-migration`。 + +`kubectl patch -n kube-system role 'system::leader-locking-kube-controller-manager' -p '{"rules": [ {"apiGroups":[ "coordination.k8s.io"], "resources": ["leases"], "resourceNames": ["cloud-provider-extraction-migration"], "verbs": ["create", "list", "get", "update"] } ]}' --type=merge` + +对 `system::leader-locking-cloud-controller-manager` 角色执行相同的操作。 + +`kubectl patch -n kube-system role 'system::leader-locking-cloud-controller-manager' -p '{"rules": [ {"apiGroups":[ "coordination.k8s.io"], "resources": ["leases"], "resourceNames": ["cloud-provider-extraction-migration"], "verbs": ["create", "list", "get", "update"] } ]}' --type=merge` + + +### 初始领导者迁移配置 + +领导者迁移需要一个表示控制器到管理器分配状态的配置文件。 +目前,对于 in-tree 云提供商, `kube-controller-manager` 运行 `route`、 `service` 和 `cloud-node-lifecycle`。 +以下示例配置显示了分配。 + +```yaml +kind: LeaderMigrationConfiguration +apiVersion: controllermanager.config.k8s.io/v1alpha1 +leaderName: cloud-provider-extraction-migration +resourceLock: leases +controllerLeaders: + - name: route + component: kube-controller-manager + - name: service + component: kube-controller-manager + - name: cloud-node-lifecycle + component: kube-controller-manager +``` + + +在每个控制平面节点上,将内容保存到 `/etc/leadermigration.conf` 中, +并更新 `kube-controller-manager` 清单,以便将文件安装在容器内的同一位置。 +另外,更新相同的清单,添加以下参数: + +- `--feature-gates=ControllerManagerLeaderMigration=true` 启用领导者迁移(这是Alpha版功能) +- `--enable-leader-migration` 在控制器管理器上启用领导者迁移 +- `--leader-migration-config=/etc/leadermigration.conf` 设置配置文件 + +在每个节点上重新启动 `kube-controller-manager`。目前,`kube-controller-manager` 已启用领导者迁移,并准备进行迁移。 + + +### 部署云控制器管理器 + +在 N + 1 版本中,控制器到管理器分配的期望状态可以由新的配置文件表示,如下所示。 +请注意,每个 `controllerLeaders` 的 `component` 字段从 `kube-controller-manager` 更改为 `cloud-controller-manager`。 + +```yaml +kind: LeaderMigrationConfiguration +apiVersion: controllermanager.config.k8s.io/v1alpha1 +leaderName: cloud-provider-extraction-migration +resourceLock: leases +controllerLeaders: + - name: route + component: cloud-controller-manager + - name: service + component: cloud-controller-manager + - name: cloud-node-lifecycle + component: cloud-controller-manager +``` + + + +当创建 N + 1 版本的控制平面节点时,应将内容部署到 `/etc/leadermigration.conf`。 +应该更新 `cloud-controller-manager` 清单,以与 N 版本的 `kube-controller-manager` 相同的方式挂载配置文件。 +类似地,添加 `--feature-gates=ControllerManagerLeaderMigration=true`、 `--enable-leader-migration` +和 `--leader-migration-config=/etc/leadermigration.conf` 到 `cloud-controller-manager`。 + +使用更新的 `cloud-controller-manager` 清单创建一个新的 N + 1 版本的控制平面节点。 +并且 `kube-controller-manager` 的 `--cloud-provider` 标志没有设置。 +N + 1 版本的 `kube-controller-manager` 不能启用领导者迁移, +因为在对于外部云提供商,它不再运行已迁移的控制器,因此不参与迁移。 + +请参阅 [云控制器管理器管理](/zh/docs/tasks/administer-cluster/running-cloud-controller/) +了解有关如何部署 `cloud-controller-manager` 的更多详细信息。 + + +### 升级控制平面 + +现在,控制平面包含 N 和 N + 1 版本的节点。 +N 版本的节点仅运行 `kube-controller-manager` ,而 N + 1 版本的节点同时运行 `kube-controller-manager` 和 `cloud-controller-manager`。 +根据配置所指定,已迁移的控制器在 N 版本的 `kube-controller-manager` 或版本 N + 1 的 `cloud-controller-manager` 下运行, +具体取决于哪个控制器管理器拥有迁移租约。任何控制器都不会在任何时候在两个控制器管理器下运行。 + +以滚动的方式创建一个新的版本为 N + 1 的控制平面节点,并将 N + 1 版本中的一个关闭,直到控制平面仅包含版本为 N + 1 的节点。 +如果需要从版本 N + 1 到 N 的回滚,则将启用了针对 `kube-controller-manager` 的领导者迁移的版本N的节点添加回控制平面,每次替换版本 N + 1 的一个,直到只有节点为止版本N。 + + +### (可选)禁用领导者迁移 {#disable-leader-migration} + +现在,控制平面已经升级,可以同时运行 N + 1 版本的 `kube-controller-manager` 和 `cloud-controller-manager` 了。 +领导者迁移已经完成工作,可以安全地禁用以节省一个租约资源。保证将来回滚重新启用领导者迁移的安全性。 + +在滚动管理器中,更新 `cloud-controller-manager` 的清单以同时取消设置 `--enable-leader-migration` +和 `--leader-migration-config=` 标志,并删除 `/etc/leadermigration.conf` 的挂载。 +最后删除 `/etc/leadermigration.conf`。 +要重新启用领导者迁移,请重新创建配置文件,并将其挂载和启用领导者迁移的标志添加回到 `cloud-controller-manager`。 + +## {{% heading "whatsnext" %}} + +-阅读 [领导者迁移控制器管理器](https://github.com/kubernetes/enhancements/tree/master/keps/sig-cloud-provider/2436-controller-manager-leader-migration) 改进建议 \ No newline at end of file