跳到主要内容
版本:v2.8

将 Amazon 从树内迁移到树外

Kubernetes 不再在树内维护云提供商。在 Kubernetes v1.27 及更高版本中,树内云提供商已被移除。当你从树内提供商迁移到树外提供商时,Rancher UI 允许你升级到 Kubernetes v1.27。

不过,如果你执行的是手动迁移,现有集群必须在迁移后升级到 Kubernetes v1.27 才能继续运行。

要从树内云提供商迁移到树外 AWS 云提供商,必须停止现有集群的 kube 控制器管理器,并安装 AWS 云控制器管理器。有许多方法可以做到这一点。有关详情,请参阅有关外部云控制器管理器的 AWS 官方文档。

如果可以接受迁移过程中出现一些停机,请按照说明设置外部云提供商。这些说明概述了如何为新配置的集群配置树外云提供商。在设置过程中,会有一些停机,因为从旧云提供商停止运行到新云提供商开始运行之间会有一段时间的间隔。

如果您的设置不能容忍任何控制平面停机,则必须启用领导者迁移。这有助于从 kube 控制器管理器中的控制器顺利过渡到云控制器管理器中的对应控制器。有关详细信息,请参阅 AWS 官方文档使用领导者迁移

Important:

Kubernetes 云控制器迁移文档指出,可以使用相同的 Kubernetes 版本进行迁移,但假设迁移是 Kubernetes 升级的一部分。请参考有关迁移到要使用的云控制器管理器的 Kubernetes 文档,了解迁移前是否需要自定义设置。确认迁移配置值。如果您的云提供商提供 Node IPAM 控制器的实现,您还需要迁移 IPAM 控制器

  1. 更新集群配置,启用领导者迁移:
spec:
rkeConfig:
machineSelectorConfig:
- config:
kube-controller-manager-arg:
- enable-leader-migration
machineLabelSelector:
matchExpressions:
- key: rke.cattle.io/control-plane-role
operator: In
values:
- "true"

请注意,云提供商在此步骤中仍是aws

spec:
rkeConfig:
machineGlobalConfig:
cloud-provider-name: aws
  1. 标记控制平面节点不可调度,以便 AWS 云控制器 pod 仅在升级到外部云提供商后才在节点上运行:
kubectl cordon -l "node-role.kubernetes.io/control-plane=true"
  1. 要安装启用了领导者迁移的 AWS 云控制器管理器,请遵循部署云控制器管理器 Chart 的步骤 1-3。从 Kubernetes 1.22 起,kube-controller-manager 将使用默认配置,该配置将满足 controller-to-manager 的迁移。更新 spec.rkeConfig.additionalManifestaws-cloud-controller-manager 的容器参数,以启用领导者迁移:
- '--enable-leader-migration=true'
  1. 安装 Chart 并确认 Daemonset aws-cloud-controller-manager 已成功部署:
kubectl rollout status daemonset -n kube-system aws-cloud-controller-manager
  1. 更新配置集群以更改云提供商,并从 kube 控制器中移除领导者迁移 参数。如果升级 Kubernetes 版本,也要在集群 YAML 文件的 spec.kubernetesVersion 部分设置 Kubernetes 版本
Important

如果不依赖 rke2 监管程序正确设置提供商 ID,则只移除 cloud-provider-name: aws

如果不想在集群中启用 enable-leader-migration 功能,请将其移除:

spec:
rkeConfig:
machineGlobalConfig:
cloud-provider-name: external

移除 enable-leader-migration

spec:
rkeConfig:
machineSelectorConfig:
- config:
kube-controller-manager-arg:
- enable-leader-migration
machineLabelSelector:
matchExpressions:
- key: rke.cattle.io/control-plane-role
operator: In
values:
- "true"
提示

您也可以在升级后禁用领导者迁移,因为由于只有一个云控制器管理器,不再需要领导者迁移,可以将其移除。升级 Chart 并从容器参数中删除以下部分:

- --enable-leader-migration=true

使用以下命令验证云控制器管理器更新是否成功上线:

kubectl rollout status daemonset -n kube-system aws-cloud-controller-manager
  1. 云提供商负责设置节点的 ProviderID。检查是否所有节点都用 ProviderID 进行了初始化:
kubectl describe nodes | grep "ProviderID"