裸金属前提条件

先完成通用前提条件,然后为裸金属准备以下内容。ac 不会创建任何机器。您需要自行提供主机。

主机操作系统和架构

global 集群的所有主机都运行相同的主机操作系统,并使用相同的主机架构。请在推送操作系统镜像之前选择操作系统和架构:

  • Alauda OS M55,仅适用于 amd64。
  • Alauda OS KU,适用于 amd64 或 arm64。

如果主机架构与 bootstrap 节点的架构不同,请使用混合 Core Package。请参阅下载。

Registry 中的操作系统镜像

按照下载 Alauda OS中的说明,下载与您在上面选择的主机操作系统和架构对应的操作系统存档。有关存档的说明,请参阅按 Provider 划分的镜像格式。

存档包含两个操作系统镜像,即 live ISO 和根文件系统。它们来自同一个存档,但不可互换。使用 global.registry 帐户,将两个镜像都推送到 global.registry 的外部 registry 中的 tkestack/ 项目。Registry 中必须存在 tkestack 项目。

在下面的表单中填写 ACP 版本、主机操作系统和架构、操作系统镜像标签(请参阅查找镜像标签)以及 registry 地址。该表单会输出两个部分:推送操作系统镜像和 install-config.yaml 的值。

以 root 身份在 bootstrap 节点上运行输出的命令。Bootstrap 节点在 /var/tmp 中需要至少有与存档大小相等的可用空间。这些命令会以 <extract-dir>/res/<arch>/packtool 身份运行 Core Package 的 packtool,其运行方式与安装中的其他命令运行 ac 的方式相同。

v4.5.0 · Kubernetes v1.36.4-acp.3

An OS image tag is the file name of its OS archive without .tar, and the tag of both images of the archive.

Push the OS images

read -rsp 'Registry password: ' REGISTRY_PASSWORD; echo
for repo in baremetal-base-image-iso baremetal-base-image; do
  <extract-dir>/res/<arch>/packtool image push <bare-metal-os-archive> \
    "<registry-address>/tkestack/${repo}:<os-image-tag-for-v4.5.0>" --ref "${repo}:<os-image-tag-for-v4.5.0>" \
    -u "<registry-username>" -p "${REGISTRY_PASSWORD}"
  curl -sSk -u "<registry-username>:${REGISTRY_PASSWORD}" \
    "https://<registry-address>/v2/tkestack/${repo}/tags/list"; echo
done
unset REGISTRY_PASSWORD

Values for install-config.yaml

provider:
  baremetal:
    isoImageTag: <os-image-tag-for-v4.5.0>
    rootImageTag: <os-image-tag-for-v4.5.0>

请勿使用 docker push 或任何其他会重写镜像 manifest 的工具进行推送。Alauda OS KU 安装程序会准确读取存档中的 manifest。

当每个 tags/list 响应都包含该标签后,再继续操作。否则,请检查 registry 地址、凭据、tkestack 项目以及推送输出。

保留 install-config.yaml 的值部分。您需要将这些值粘贴到在裸金属上创建 global 集群中的 install-config.yaml。

查找镜像标签

两个镜像使用相同的标签:不带 .tar 的存档文件名,例如 alaudaos-44.m55.202610030151-0.x86_64。该标签同时是 isoImageTag 和 rootImageTag 的值。

稍后若要在 registry 中查找标签,请在能够访问 registry 的主机(例如 bootstrap 节点)上运行以下命令。如果 registry 不需要凭据,请省略 read 行和 -u 选项。

# Alauda OS M55
ISO_REPO=baremetal-base-image-iso; ROOT_REPO=baremetal-base-image
# Alauda OS KU
# ISO_REPO=kubeos-iso; ROOT_REPO=kubeos-rootfs

read -rsp 'Registry password: ' REGISTRY_PASSWORD; echo
for repo in "${ISO_REPO}" "${ROOT_REPO}"; do
  curl -sSk -u "<registry-username>:${REGISTRY_PASSWORD}" \
    "https://<registry-address>/v2/tkestack/${repo}/tags/list"; echo
done
unset REGISTRY_PASSWORD

输出会列出每个 repository 的标签,以下是 Alauda OS M55 的示例:

{"name":"tkestack/baremetal-base-image-iso","tags":["<os-image-tag>"]}
{"name":"tkestack/baremetal-base-image","tags":["<os-image-tag>"]}
  • tkestack/baremetal-base-image-iso 的标签(Alauda OS KU 使用 tkestack/kubeos-iso)是 ISO 镜像标签。
  • tkestack/baremetal-base-image 的标签(Alauda OS KU 使用 tkestack/kubeos-rootfs)是根文件系统镜像标签。

如果某个 repository 列出了多个标签,请使用与此 ACP 版本和主机架构对应的已下载存档的标签。例如,如果之前推送过其他版本或架构的镜像,就可能出现这种情况。

主机

为 global 集群中的每个节点提供一个主机。主机数量为 controlPlane.replicas,加上 computes 中每个节点组的 replicas 数量。例如,3 个控制平面节点和 3 个工作节点需要 6 台主机。

每台主机随后都会启动安装 ISO,该 ISO 由 create 的首次运行构建,具体请参阅构建安装 ISO。在启动该 ISO 之前,准备好每台主机:

  • 擦除 OS 安装磁盘和任何旧的启动磁盘,确保主机不会启动旧 OS。请参阅磁盘和启动顺序。
  • 将虚拟 CD 或 ISO 置于启动顺序的第一位。
  • 在 BIOS/UEFI 设置中或通过 BMC 设置时钟。所有主机使用相同的时区,并且它们的时钟差异最多为 10 秒。请参阅时钟。
  • 如果网络未为主机提供 DHCP 地址,请确保可以打开主机控制台来配置地址。请参阅实时 ISO 中的网络。
  • 对于 arm64 主机,请确保 SMBIOS 数据可用。没有 SMBIOS 的 arm64 主机无法注册。请参阅arm64 主机。

网络

  • 实时 ISO 启动期间的地址,该地址通过 DHCP 获取,或按照实时 ISO 中的网络中的说明在主机控制台上配置。
  • 从主机到引导节点地址的路由,该地址是主机用来访问引导节点的 IPv4 地址。主机通过此地址在端口 12443 上注册。在从引导集群移交到 global 集群之前,主机上的代理也会通过此地址读取其计划。ISO 下载 URL 使用相同的地址和端口,因此用于下载 ISO 的计算机也需要到该地址的路由。有关主机到引导节点的数据流,请参阅安装。
  • 控制平面端点,按照规划控制平面端点中的规划设置。它可以是带有 VRID 的自建 VIP,也可以是外部负载均衡器。负载均衡器必须转发平台访问地址和 global VIP中在负载均衡器上转发列标记为是的每个端口。在第二次运行 create 之前,按照安装集群中的说明,将控制平面主机添加为其后端。如果主机从 DHCP 获取地址,则只有在主机注册后才能知道这些地址。

后续步骤

除了通用值之外,您现在还拥有:

  • 主机 OS 和架构。
  • 表单打印的 install-config.yaml 值:ISO 镜像标签和根文件系统镜像标签。
  • bootstrap 节点地址。

继续执行在裸金属上创建 global 集群。