裸金属业务集群的前置条件

在注册主机和创建集群之前,请满足以下前置条件。这些条件也适用于之后添加到集群中的每个主机。

提供商

在 global 集群上安装以下集群插件:

  • Alauda Container Platform Cluster Bootstrap Provider
  • Alauda Container Platform Infrastructure Provider for Bare Metal,该插件会安装裸金属管理器和 elemental-operator

如果 global 集群是通过 ac 在 Bare Metal 上安装的,则其中已运行这两个插件。否则,请从 ACP Common Aligned Extensions 下载这两个插件(参见下载),使用 violet push 上传(参见上架软件包),并按照集群插件中的说明安装。在灾难恢复对中,请在两个 global 集群上都安装这两个插件。

平台证书

适用于:使用用户提供的证书来配置平台访问地址的平台。如果 provider 已安装且 elemental-operator 正在运行,请跳过本节。

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

ac config use-cluster global
ac -n cpaas-system get secret dex.tls -o jsonpath='{.data}' | jq -r 'keys | join(",")'

当 keys 中包含 ca.crt 时继续操作。否则,在裸金属 Infrastructure Provider 的 ModuleInfo 的 spec.valuesOverride 中设置 elemental.tls.caCertSecretKey: tls.crt:

spec:
  valuesOverride:
    acp/chart-cluster-api-provider-baremetal:
      elemental:
        tls:
          caCertSecretKey: tls.crt
  • 如果尚未安装该插件,请按照通过 YAML 安装中的说明,使用 YAML 安装,并在 ModuleInfo 中包含此值。Web Console 表单没有此设置对应的字段。

  • 如果该插件已安装,请将此值添加到其现有的 ModuleInfo 中,并保留 valuesOverride 下的其他 keys。ModuleInfo 名称会在安装时生成,因此请根据插件标签查找:

    ac get moduleinfo -l cpaas.io/module-name=cluster-api-provider-baremetal

    然后运行 ac edit moduleinfo <name>,将 <name> 替换为输出中的 NAME。

网络连接

主机通过网络注册、安装并加入集群。在第一台主机启动 ISO 之前,开放以下流量:

平台会在 Alauda OS 节点上维护主机防火墙;请参阅管理防火墙端口。

请勿从在安装 global 集群期间构建的 ISO 启动业务主机。此类主机会向引导节点注册。

控制平面端点。对于自建 VIP,VIP 必须与控制平面节点 IP 位于同一二层域中,并且其 VRID 在该域中必须唯一。必须允许 VRRP 和免费 ARP。对于外部负载均衡器,请在运行 create 之前配置侦听器和后端;请参阅规划控制平面端点。

首次启动时的地址配置。如果主机在实时 ISO 中未获取 DHCP 地址,请通过主机控制台配置静态地址;请参阅实时 ISO 中的网络。

镜像仓库

在运行 create 之前,确定集群从哪个仓库拉取镜像;集群创建后无法更改。

  • global 集群的仓库,这是默认选项。ac 从 global 集群上 cpaas-system/public-registry-credential 的 registry 键读取其地址。即使仓库无需身份验证,Secret 也必须存在。
  • 专用仓库,用于存储平台组件镜像。请遵循为业务集群选择镜像仓库中的说明。

无论选择哪种方式:

  • 每次重新安装主机时,主机会从集群的仓库拉取其 OS 镜像,并使用集群的仓库帐户,无论镜像目录条目中指定的是哪个仓库。如果仓库需要身份验证,该帐户必须具有拉取 OS 镜像的权限。使用专用仓库时,也请将 OS 镜像推送到该仓库;请参阅推送 OS 镜像。
  • ISO 是例外:global 集群会根据 SeedImage 的 baseImage 构建 ISO,内容与其中的写法完全一致。

主机

按照为主机准备 Alauda OS中的说明准备 OS,并按照注册主机中的说明注册主机。每个节点需要一个可用主机:所需主机数等于 controlPlane.replicas 加上 computes 中每个节点组的 replicas 之和。例如,3 个控制平面节点和 3 个工作节点需要 6 台主机。

节点标签和污点

若要为监控、日志记录或入口保留某个池中的节点,请按照基础设施节点中的说明,在创建节点池之前规划其角色标签和污点。