注册主机

主机注册一次后,在其整个生命周期内都会保持注册状态。它会引导与其 OS 和架构对应的 ISO,与 global 集群注册为 MachineInventory,并将 Alauda OS 安装到你选择的系统磁盘。注册的主机会一直处于可用主机状态,直到某个集群通过该集群的池接管它;请参阅工作原理。

开始前,请按照为主机准备 Alauda OS中的说明,创建注册以及与主机 OS 和架构对应的 ISO。

请在一台 ac 已登录平台的计算机上运行本页中的 ac 命令。

可用主机

可用主机是满足以下条件的 MachineInventory:

  • 是 Ready=True。
  • 具有 status.install.phase=Installed。
  • 在 status.plan.secretRef.name 中具有计划 Secret。
  • 未列在任何 MachineInventoryPool 中。

列出主机:

ac config use-cluster global
ac -n cpaas-system get machineinventories.elemental.cattle.io \
  -o custom-columns='NAME:.metadata.name,READY:.status.conditions[?(@.type=="Ready")].status,PHASE:.status.install.phase,PLAN:.status.plan.secretRef.name,ARCH:.metadata.labels.os\.baremetal\.alauda\.io/arch,OS:.metadata.labels.os\.baremetal\.alauda\.io/id,POOL:.metadata.annotations.baremetal\.alauda\.io/pool'

满足以下条件时,主机处于可用状态:

  • READY 为 True。
  • PHASE 为 Installed;对于在 ACP 4.5 之前注册的主机,则为 <none>。
  • PLAN 不为 <none>。
  • POOL 为 <none>。对于某个池列出的主机,POOL 会显示该池。

ARCH 和 OS 显示主机的架构和 OS。名称为 global-* 的主机属于 global 集群。请勿将它们放入业务集群的池中。

准备主机

在每台主机引导 ISO 之前,按以下步骤准备主机。在第一台主机引导之前,打开网络连接中所述的网络流量。

磁盘和引导顺序

在主机引导 ISO 之前,对其上的每个磁盘和虚拟磁盘进行分类。记录 OS 安装目标磁盘以及必须保留其数据的磁盘:

  • 擦除 OS 安装磁盘和任何已废弃的引导磁盘,确保主机引导 ISO,而不是旧 OS。
  • 安装过程会擦除其他磁盘中早期安装遗留的系统分区(COS_* 标签)。当某个磁盘无法安全擦除时,主机会在安装前停止。它会在其 MachineInventory 的 status.install.staleSystemDisks 中列出该磁盘,同时显示 action: Blocked 及原因。清理该磁盘,然后再次从 ISO 引导主机。
  • 首先引导虚拟 CD 或 ISO。对于弹出 CD 不生效的虚拟机,请先从磁盘引导,再从 CD 引导。

时钟

确保每台主机在引导 ISO 时都具有正确的时间:所有节点使用相同的时区,并且节点之间的时间差最多为 10 秒,如节点检查中所述。本操作步骤不会为你检查时间。时钟错误的主机会阻止控制平面启动。

  • 确保站点的 NTP 服务器可通过 UDP 123 访问,并在 install-config.yaml 的 cluster.ntpServers 中将其设置为集群的 NTP 服务器。此后,每个节点从作为节点首次启动开始,就会通过 chronyd 与这些服务器同步。生产集群不应依赖公共 NTP。
  • 在 BIOS/UEFI 设置中或通过 BMC 设置时钟。由于安装磁盘会被擦除,无法从 OS 中设置时钟。将硬件时钟保持为 UTC。
  • 相互比较各主机的时钟。一个集群中各主机之间的时间差必须保持在 10 秒以内。
  • 节点处于 Ready 状态后,在每个节点上使用 timedatectl 和 chronyc tracking 确认时间。

如配置 Chrony 时间服务中所述,Day-2 chrony MachineConfig 不能替代这些步骤,因为它只配置正在运行的节点。

Live ISO 中的网络

如果主机在 Live ISO 中未获取 DHCP 地址,请在等待注册之前从主机控制台进行配置:

nmcli connection show
nmcli connection modify "Wired connection 1" \
  ipv4.method manual \
  ipv4.addresses <host-ip>/<prefix-length> \
  ipv4.gateway <gateway-ip> \
  ipv4.dns <dns-ip> \
  ipv4.ignore-auto-dns yes
nmcli connection up "Wired connection 1"

arm64 主机

arm64 主机必须提供 SMBIOS 数据。不具有 SMBIOS 的 arm64 计算机无法注册。

引导主机

从与每台主机的操作系统和架构对应的 ISO 引导每台主机。ISO 在 global 集群上构建,具体说明请参阅创建注册和 ISO。从下载 URL 下载 ISO,并按照验证 ISO中的说明进行验证。如果 URL 为空或已过期,请按照重建 ISO中的说明重建 ISO。要查看注册信息、构建每个注册所使用的 ISO 映像以及当前下载 URL,请运行:

ac config use-cluster global
ac -n cpaas-system get seedimages.elemental.cattle.io \
  -o custom-columns='NAME:.metadata.name,BASE:.spec.baseImage,REASON:.status.conditions[?(@.type=="SeedImageReady")].reason,URL:.status.downloadURL'

BASE 中的标签会标明 ISO 的操作系统、架构和 ACP 版本。

每台主机会注册为名为 <name>-<system-uuid> 的 MachineInventory,其中 <name> 是注册名称。然后,主机会报告其磁盘,并在 Live 环境中等待,直到你选择其系统磁盘。如果主机在 Live ISO 中未获取 DHCP 地址,请按照Live ISO 中的网络中的说明配置网络。

选择系统磁盘

每台主机都会等待你选择其系统磁盘,即使主机只有一个磁盘也是如此。列出主机以及等待中的主机报告的磁盘:

ac config use-cluster global
ac -n cpaas-system get machineinventories.elemental.cattle.io \
  -o custom-columns='NAME:.metadata.name,PHASE:.status.install.phase,IP:.metadata.labels.elemental\.cattle\.io/registration-ip'
ac -n cpaas-system get machineinventories.elemental.cattle.io <inventory-name> \
  -o jsonpath='{range .status.install.candidates[*]}{.id}{"\t"}{.eligible}{"\t"}{.path}{"\t"}{.sizeBytes}{"\t"}{.reasons}{"\n"}{end}'

等待中的主机会显示 AwaitingTarget。IP 是主机用于访问 global 集群的地址,因此你可以将清单与主机进行匹配。每行候选项会打印以下值:

  • 磁盘 ID。
  • 磁盘是否可以选择。
  • 磁盘在 Live 环境中的设备路径。
  • 磁盘的字节大小。
  • 磁盘无法选择的原因(如果有)。

根据大小和路径识别系统磁盘。在主机仍处于 Live 环境时,使用其 ID 选择该磁盘:

ac -n cpaas-system annotate machineinventories.elemental.cattle.io <inventory-name> \
  baremetal.alauda.io/install-target-device=<disk-id>
  • 选择显示 true 的磁盘,并使用其原样打印的 ID。
  • 阶段会变为 Installing,主机会将 Alauda OS 安装到该磁盘并重新启动。之后无法更改此选择。
  • 如果由于最近未检测到主机而拒绝该注解,请确保主机仍在运行 ISO,然后再次运行该命令。
  • 选择磁盘需要在 cpaas-system 中的 machineinventories 上具备 patch,并在 machineinventories/installtarget 上具备 update。

确认注册

使用可用主机中的命令列出主机。仅在主机满足以下条件时使用:

  • 显示 READY True、PHASE Installed,且 PLAN 不为 <none>。
  • 在 ARCH 和 OS 中显示注册设置的 os.baremetal.alauda.io/arch 和 os.baremetal.alauda.io/id 标签值。没有这些标签的主机会被视为运行 Alauda OS M55 的 amd64。
  • 当主机每次重新安装时都必须保留安装时的 IP 时,其 spec.observedNetwork 与该主机预期的 NIC 匹配。

记录池的准确 MachineInventory 名称。如果主机不满足这些条件,请参阅故障排除。

故障排除

结果操作
主机未显示为 MachineInventory在主机控制台中,检查主机是否启动了 ISO,而不是磁盘上的旧操作系统;请参阅磁盘和启动顺序。检查主机在 Live ISO 中是否具有网络地址;请参阅Live ISO 中的网络。检查准备主机中的网络流量是否已放行。检查主机启动的 ISO 是否基于 global 集群构建,而不是在安装 global 集群时构建的 ISO。arm64 主机必须提供 SMBIOS;请参阅arm64 主机。如果以上条件均满足,请联系技术支持。
MachineInventory 显示 status.install.phase=AwaitingTarget主机正在等待系统磁盘。按照选择系统磁盘中的说明选择系统磁盘。
主机在安装前停止,且其 MachineInventory 在 status.install.staleSystemDisks 中列出了带有 action: Blocked 的磁盘磁盘上存在早期安装的系统分区(COS_* 标签),无法安全擦除。请在 status.install.staleSystemDisks 中查看原因。可以在主机控制台中清理该磁盘,也可以在候选列表显示该磁盘带有 true 时将其用作系统磁盘;该磁盘上的所有内容都会被擦除。然后再次选择系统磁盘,因为之前的选择已被丢弃。主机在 ISO 中等待期间会再次检查磁盘。请参阅磁盘和启动顺序。
MachineInventory 返回 AwaitingTarget,status.install.message 指示安装未完成,且清单中有一个 InstallInterrupted 事件主机在安装期间重新启动,例如因断电导致。请再次选择其系统磁盘。
MachineInventory 返回 AwaitingTarget,且 status.install.message 指示安装完成后主机再次启动了 Live ISOISO 仍处于连接状态。移除 ISO 并从磁盘启动主机;已安装的系统会保留。如果要重新安装,请选择一个磁盘。
磁盘注解遭到拒绝查看提示信息。如果最近未检测到主机,请确保主机仍在运行 ISO,然后再次运行命令。如果磁盘不在候选列表中或不符合条件,请使用候选列表显示其带有 true 的 ID。设备路径(例如 /dev/sda)或 wwn:0x… 格式会遭到拒绝;提示信息会说明应使用哪种格式。如果提示信息中提到 ClusterRole baremetal-install-target-approver,则你的账户缺少选择系统磁盘中列出的权限;请以平台管理员身份运行命令。
MachineInventory 不为 Ready=True,或其 PLAN 为 <none>等待主机安装 Alauda OS 并重新启动,然后再次列出主机。如果状态没有变化,请联系技术支持。
ISO 的下载 URL 为空或已过期按照重新构建 ISO中的说明重新构建 ISO。如果 SeedImageReady 的原因不是 SeedImageBuildSuccess,请先按照推送 OS 镜像中的说明检查 registry 中是否有 ISO 镜像。
Alauda OS KU 主机安装失败,并显示 kubeos install requires elemental.install.system-uri注册中没有 install.system-uri。按照为主机准备 Alauda OS中的说明重新生成注册信息并应用,然后按照重新构建 ISO中的说明重新构建 ISO,并从新 ISO 启动主机。
Alauda OS KU 主机安装失败,且 status.install.message 指示在磁盘上找不到分区,例如 partition ROOT-A not found on /dev/sdh after install使用相同的 ID 再次选择系统磁盘。如果安装再次失败,请联系技术支持。

后续步骤