安装 VMware vSphere Provider
本文介绍如何安装 Virtualization Platform 的 Infrastructure Provider 和 Cluster Bootstrap Provider,以及如何验证所需的 Cluster API 组件在 global 集群上是否可用。
适用场景
当 global 集群运行在其他基础设施上时,请在 VMware vSphere 上创建第一个业务集群之前完成本页所述操作:ac 只会安装对应基础设施的 provider。使用 ACP CLI (ac) 在 VMware vSphere 上安装的 global 集群已运行这两个 provider,因此可以跳过本页。在灾难恢复 (DR) 配对中,请在两个 global 集群上完成此操作,以便发生故障转移后,备用集群能够协调相同的业务集群。请将软件包上传到每个 global 集群。
前提条件
安装 provider 之前,请确保满足以下条件:
- 您可以访问
global集群。 - 您可以访问 Customer Portal,以下载 provider 软件包。
- 集群通过
VSphereCluster.spec.identityRef引用的 vCenter 账户可以列出、创建和设置 VM 自定义属性。请授予 Global → Manage custom attributes 和 Global → Set custom attribute 权限。每当VSphereCluster或其 CAPICluster带有任何vsphere.cluster.x-k8s.io/*注解时,provider 都需要这些权限;如果缺少权限,VM 协调将失败,而不是跳过元数据写入。
操作步骤
下载所需软件包
要在 VMware vSphere 上创建集群,需要两个集群插件。请从 Customer Portal 下载这两个插件。对于 4.5,它们位于 ACP Common Aligned Extensions 中;请参阅下载。
- Alauda Container Platform Cluster Bootstrap Provider
- Alauda Container Platform Infrastructure Provider for Virtualization Platform
上传软件包
使用 violet push 将两个软件包上传到平台。有关命令及其参数,请参阅上架软件包。
安装集群插件
在 global 集群上安装两个集群插件。有关操作步骤,请参阅集群插件。
验证安装
在已登录平台的 ac 所在机器上运行以下命令:
满足以下条件后即可继续:
- 两个插件均已列出,且
Running。 - CRD 列表包含九个 CRD:
vsphereclusters、vsphereclusteridentities、vsphereclustertemplates、vspheredeploymentzones、vspherefailuredomains、vspheremachines、vspheremachineconfigpools、vspheremachinetemplates和vspherevms,且均处于infrastructure.cluster.x-k8s.io。 - Webhook 列表包含
validation.vspherecluster.infrastructure.cluster.x-k8s.io、validation.vspheremachineconfigpool.infrastructure.cluster.x-k8s.io、validation.vspheremachinetemplate.infrastructure.cluster.x-k8s.io和validation.kubeadmcontrolplane.capv.cluster.x-k8s.io。
否则,请按照集群插件中的说明重新安装缺失的插件,或联系技术支持。
升级 Provider
该 provider 是一个 Aligned Extension,会与 global 集群一同升级。按照准备升级中的说明,使用 violet 发布目标版本的 provider 软件包;随后,Cluster Version Operator(CVO)会在集群升级过程中升级已安装的集群插件。请参阅升级 global 集群。
升级还会更新 provider CRD。某些字段会在不同版本之间迁移,但现有资源会自动为你迁移——不要手动编辑 VSphereMachineConfigPool 或任何其他 provider 对象以匹配新架构,也不要删除并重新创建对象。控制器会在升级后的首次调谐中,将每个对象更新为当前布局:
- 不会修改控制平面端点。现有集群的
spec.controlPlaneLoadBalancer保持未设置状态,这正是外部 LoadBalancer 的表现,并且会继续保持不变:API server 地址不会更改,也不会向业务集群中部署任何内容。 - 之前记录在
spec.configs[].persistentDisks[].volumePath和.diskUUID上的每个磁盘状态,以及status.configStatuses[].reclaimStatus下的每个插槽回收状态,都会合并到status.persistentDiskStatuses[]中。正在进行的回收会保留其阶段和任务引用并继续执行,随后清除reclaimStatus,使状态具有唯一数据源。 - 已弃用的
spec字段会保留在对象中。请将其视为历史记录,并改为读取status.persistentDiskStatuses[]。 - 迁移不会覆盖已经设置的值,因此可以安全地重复执行。磁盘部分仅用于记录状态,并且会在联系 vCenter 之前运行,因此即使 vCenter 无法访问,也能完成迁移。
- 迁移仅涵盖 provider 自身的资源。Cluster API 对象上所需的 rollout 值——
maxSurge和replicas——永远不会被重写,因此,现有的不包含这些值的KubeadmControlPlane或MachineDeployment仍必须手动修正。请参阅设置 Rollout 配置。
不会修改业务集群中的任何内容,也不会替换任何 VM。升级前需要了解以下三个影响:
- 在较早 provider 上创建的集群会保留其外部 LoadBalancer;请参阅控制平面端点。
- 池会保留其创建时使用的磁盘列表。升级不会将任何现有磁盘移入
spec.configs[].ephemeralDisks[]:在较早 ACP 版本上创建的集群会继续将/var/cpaas、/var/lib/containerd和/var/lib/etcd作为持久磁盘使用。新集群文档中介绍的持久磁盘与临时磁盘拆分属于创建时布局。请参阅添加数据磁盘。 - 通过
guestinfo用户数据传递的来宾端更改(例如 pod 日志迁移)只有在节点被替换时才会应用到该节点。请参阅Pod 日志目录。
按照验证安装中的检查确认结果,然后读取一个池:
升级前已完成配置的每个磁盘都会显示一个阶段,而 status.configStatuses[].reclaimStatus 已消失。从未被任何 Machine 分配过的插槽上的磁盘尚未拥有 VMDK,因此不会有记录;这是预期行为,并不表示迁移未完成。
后续步骤
安装 provider 后,请继续执行以下操作: