安装 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 或其 CAPI Cluster 带有任何 vsphere.cluster.x-k8s.io/* 注解时,provider 都需要这些权限;如果缺少权限,VM 协调将失败,而不是跳过元数据写入。

操作步骤

下载所需软件包

要在 VMware vSphere 上创建集群,需要两个集群插件。请从 Customer Portal 下载这两个插件。对于 4.5,它们位于 ACP Common Aligned Extensions 中;请参阅下载。

  1. Alauda Container Platform Cluster Bootstrap Provider
  2. Alauda Container Platform Infrastructure Provider for Virtualization Platform

上传软件包

使用 violet push 将两个软件包上传到平台。有关命令及其参数,请参阅上架软件包。

安装集群插件

在 global 集群上安装两个集群插件。有关操作步骤,请参阅集群插件。

验证安装

在已登录平台的 ac 所在机器上运行以下命令:

ac config use-cluster global
ac get minfo -l cpaas.io/module-name=cluster-api-provider-vsphere
ac get minfo -l cpaas.io/module-name=cluster-api-provider-kubeadm
ac get crd | grep -E '^vsphere[a-z]+\.infrastructure\.cluster\.x-k8s\.io\b'
ac get validatingwebhookconfiguration \
  -o jsonpath='{range .items[*]}{range .webhooks[*]}{.name}{"\n"}{end}{end}' \
  | grep -E 'vsphere|capv'

满足以下条件后即可继续:

  • 两个插件均已列出,且 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 日志目录。

按照验证安装中的检查确认结果,然后读取一个池:

ac config use-cluster global
ac -n cpaas-system get vspheremachineconfigpool <pool-name> \
  -o jsonpath='{range .status.persistentDiskStatuses[*]}{.hostname}{" "}{.name}{" "}{.phase}{"\n"}{end}'

升级前已完成配置的每个磁盘都会显示一个阶段,而 status.configStatuses[].reclaimStatus 已消失。从未被任何 Machine 分配过的插槽上的磁盘尚未拥有 VMDK,因此不会有记录;这是预期行为,并不表示迁移未完成。

后续步骤

安装 provider 后,请继续执行以下操作: