裸金属 Provider

裸金属 Infrastructure Provider 可直接在物理服务器上创建 Alauda OS 集群,无需虚拟化层。规划集群时,请注意以下裸金属专属事项:

  • Provider 不会创建机器。您需要在 global 集群中注册每台主机,并在 MachineInventoryPool 中列出每个节点组的主机;请参阅工作原理。ac 会渲染集群对象,但不会注册主机或创建资源池。
  • 主机的注册独立于任何集群。一次注册及其 ISO 可供所有集群中使用相同 OS 和架构的所有主机使用;请参阅为主机准备 Alauda OS。
  • 主机在其整个生命周期内保持注册状态,并在其资源池与该资源池所属集群之间移动;请参阅工作原理。每个资源池中的主机数量至少与其节点组的 replicas 相同;额外的主机用作备用主机。
  • 每次重新安装主机时,都会清除其 Kubernetes 状态。
  • 主机保留注册时使用的网络地址。
  • 镜像目录 elemental-image-catalog 必须包含集群所用每个 Kubernetes 版本对应的键,且需匹配主机的架构和 OS;请参阅添加镜像目录键。
  • 平台升级也会升级这些集群上的 Kubernetes 和 Alauda OS。升级前会先检查每个集群,然后依次升级至镜像目录中已暂存的每个中间 Kubernetes 版本;请参阅由谁升级 Kubernetes。
  • 控制平面端点可以是控制平面节点上的自建 VIP(internal,默认值),也可以是您的外部负载均衡器。

工作原理

global 集群从不连接主机。它会将主机需要执行的操作(即计划)写入主机的计划 Secret,主机上的智能体会读取并应用该计划。

主机经历两个阶段:

  • 注册:每台主机仅注册一次,且独立于工作负载集群。主机从 ISO 启动并向 global 集群注册,该集群会将其记录为 MachineInventory。随后,主机会在您选择的系统盘上安装 Alauda OS;安装后的系统会运行智能体,以接收主机计划。
  • 集群使用:每当集群从其某个节点组的 MachineInventoryPool 中获取主机时,都会重新安装主机,并使用 elemental-image-catalog 映射到该集群 Kubernetes 版本的 OS 镜像,然后将其加入集群。移除节点时,主机会停止运行 Kubernetes,并返回资源池;其已安装的系统保持不变,直到再次被集群获取。

主机连接到平台地址以完成注册并读取计划,然后从其加入的集群的 registry 拉取 OS 镜像。global 集群中的主机则通过控制平面端点读取计划;请参阅global 集群的主机。有关所有网络流量,请参阅网络连接。

共有四个程序负责这些工作:Infrastructure Provider for Bare Metal 插件会在 global 集群的 cpaas-system 中安装其中两个,另外两个则运行在每台主机上:

组件运行位置角色
elemental-operatorglobal 集群构建注册 ISO,并将每台主机注册为 MachineInventory。
cluster-api-provider-baremetal-manager,provider managerglobal 集群从集群的资源池中获取主机并写入其计划:reprovision 会重新安装主机并将其加入集群;移除节点时,clean 会停止主机上的 Kubernetes。
elemental-register主机,从 ISO 启动注册主机,并在所选系统盘上安装 Alauda OS。
elemental-system-agent主机,已安装的系统从 global 集群读取主机计划并应用该计划。

安装 global 集群期间,相同的组件会在引导集群上运行;安装结束时,主机会迁移到 global 集群。

BaremetalMachine 阶段

BaremetalMachine 会依次经过 Pending → Allocated → Reprovisioning → Running。失败时,它会进入 Failed。删除后,provider 会清理主机。在清理完成之前,其 MachineInventory 的 baremetal.alauda.io/allocation-state 注解为 Preparing;清理完成后,它会再次变为 Available,并在资源池中处于空闲状态。

文档

请按以下顺序阅读各页面:

  1. 前提条件
  2. 为主机准备 Alauda OS
  3. 注册主机
  4. 创建集群
  5. 故障排除,当创建阶段没有推进时
  6. 删除集群

相关内容:参数、管理节点、升级概述、API 参考。