VMware vSphere 业务集群的先决条件
在创建集群之前,请满足以下条件。ac不会创建此页面列出的任何 vCenter 对象,而是在应用任何内容之前对其进行检查。
目录
ProvidervCenter 可达性VM 模板VM Template ConfigMap控制平面端点静态 IP 地址ClusterResourceSet镜像仓库vCenter 凭证 Secret节点标签和污点Provider
确保在 global 集群上安装了 Cluster Bootstrap Provider 和 Infrastructure Provider for Virtualization Platform。在 VMware vSphere 上使用 ac 安装的 global 集群已运行这两种 Provider。否则,请参阅安装 Provider。
vCenter 可达性
允许VMware vSphere列出的到 vCenter 的流量。流量来源包括 global 集群、业务集群节点,以及运行 ac 的机器。
VM 模板
确保 vCenter 中存在 VM 模板、数据中心、端口组、数据存储和计算资源。使用为目标平台版本发布的 Alauda OS 镜像创建 VM 模板,且不要修改该镜像。该镜像包含 ac 所安装的 Kubernetes 版本,即平台支持的最新 Kubernetes 版本。请参阅 OS 支持矩阵。
VM Template ConfigMap
创建模板时,在 global 集群上使用 ConfigMap 注册每个 VM 模板。创建集群时不会读取这些 ConfigMap,平台升级时才会读取。ACP 无法发现 vCenter 中的 VM 模板,因此升级过程只能从这些 ConfigMap 中获取模板信息。每个 VM 模板创建一个 ConfigMap。ConfigMap 记录以下信息:
- VM 模板的名称。
- VM 模板所使用的 Alauda OS 镜像对应的 ACP 版本。
- 该 ACP 版本的 Kubernetes 版本和 etcd 标签。
平台升级会使用这些 ConfigMap 查找每个 Kubernetes 版本对应的 VM 模板,因此每个 vSphere 集群都需要这些 ConfigMap。升级前,请在集群使用的每个数据中心中部署升级路径上各版本对应的 VM 模板,并确保名称相同。然后按照暂存 Alauda OS 镜像中的说明注册每个 VM 模板。
请遵循以下规则:
- 保留早期 ACP 版本的 ConfigMap。
- 每个 ACP 版本只注册一个 VM 模板。
cpaas.io/vsphere-vm-template标签的值必须与 vCenter 中的 VM 模板名称相匹配。
先运行 ac config use-cluster global,然后运行生成器输出的命令。
Run the command on the global cluster. In a DR environment, run it on both global clusters: the ConfigMaps are not synchronized between them.
For each ACP version, register VM templates of only one OS on a global cluster. When VM templates of different OSes have the same Kubernetes version, an upgrade can move a cluster to the other OS.
检查 VM 模板对应的 ConfigMap 是否存在。在已通过 ac 登录平台的机器上运行以下命令:
如果没有 ConfigMap 列出该 VM 模板名称,请创建该 VM 模板对应的 ConfigMap。
控制平面端点
每个集群都通过稳定的端点访问其 API server。在编写 install-config.yaml 之前选择模式。集群创建后无法更改模式。例如,现有集群无法切换到自建 VIP。
静态 IP 地址
为每个节点分配一个主机名和一个静态 IPv4 地址,并为每个额外的 NIC 分配一个地址。确保每个地址都已分配且未被使用。在创建集群之前,规划每台主机的地址和磁盘。机器占用插槽后,无法更改这些设置;请参阅已分配插槽限制。
ClusterResourceSet
vSphere 云提供商通过 global 集群上的 Cluster API ClusterResourceSet 访问业务集群。无需为此进行任何准备。如果集群创建后节点仍未初始化,请参阅故障排除。
镜像仓库
集群从 global 集群的仓库或专用仓库中拉取其平台组件。请参阅为业务集群选择镜像仓库。业务节点必须能够访问该仓库。仓库必须包含集群所需的内容:Kube-OVN chart、CoreDNS 仓库和 vSphere CPI 标签。
vCenter 凭证 Secret
在 global 集群的 cpaas-system 命名空间中创建 vCenter 凭证 Secret。ac 不会创建该 Secret。集群通过名称引用该 Secret。与 global 集群不同,该集群不会保存内联凭证。使用编辑器将账户信息写入 vsphere-credential.env,每行一个 key=value,且不加引号:
请妥善保护该文件(chmod 600 vsphere-credential.env),因为其中包含密码。
在已登录平台的 ac 所在机器上运行以下命令。最后一条命令会删除该文件:
不要使用 ac apply 创建 Secret,因为它会将密码存储在 Secret 的注解中。
每个集群使用一个 Secret。提供商删除集群时也会删除该 Secret。重新创建集群前,请再次创建该 Secret。ac 会使用同一账户生成 CPI 凭证。无需另行准备一份凭证。
该账户必须能够读取清单。此外,还必须能够克隆、启动、重新配置和删除 VM 及其磁盘。如果使用了自定义属性,该账户还需要具备安装 Provider中列出的权限。
节点标签和污点
若要将节点组专用于监控、日志记录或入口流量等用途,请按照基础设施节点中的说明,在创建集群前规划其角色标签和污点。