为主机准备 Alauda OS

主机通过从 ISO 启动加入平台。在此页面中,您将构建该 ISO:为主机的每个 OS 和架构分别创建一个注册信息和一个 ISO。每个注册信息可供其 OS 和架构的主机用于每个业务集群。请在注册主机之前完成此操作。

请先满足 裸金属前提条件。在已登录平台的 ac 所在的计算机上运行本页面中的 ac 命令。

找到适合您的情况,并按照相应章节操作:

您的情况要遵循的章节
global 集群已使用 ac 在裸金属上安装。主机与 global 集群的主机具有相同的 OS 和架构,并且这些主机属于一个使用 global 集群注册表的新集群。先执行生成命令,然后执行创建注册信息和 ISO。global 集群的安装已推送镜像并添加镜像目录密钥。
任何其他新集群:使用其他 OS 或架构的主机、具有专用注册表的集群,或未使用 ac 在裸金属上安装的 global 集群。按顺序执行所有章节。
现有集群的较旧版本需要使用从未使用过的架构的主机。使用该集群的 ACP 版本生成命令,然后推送 OS 镜像并添加镜像目录密钥。

生成命令

针对每个 OS 各填写一次以下生成器:

字段值
ACP 版本global 集群的 ACP 版本。新集群始终使用此版本。
OSAlauda OS M55 或 Alauda OS KU。一个集群中的所有主机运行相同的 OS。
架构主机的架构。Alauda OS M55 主机为 amd64。Alauda OS KU 集群的主机可以混用 amd64 和 arm64。
OS 映像标签每个架构一个:OS 归档文件的文件名,不含 .tar。请参阅查找映像标签。
注册表地址global 集群的注册表。生成器会显示用于打印该地址的命令。

生成器会打印以下输出:

For the registry of the global cluster, run ac config use-cluster global, then ac -n cpaas-system get secret public-registry-credential -o jsonpath='{.data.registry}' | base64 -d.

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

amd64
read -rsp 'Registry password: ' REGISTRY_PASSWORD; echo
for repo in baremetal-base-image-iso baremetal-base-image; do
  <extract-dir>/res/<host-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

Add the image catalog keys

ac -n cpaas-system patch configmap elemental-image-catalog --type merge --patch-file /dev/stdin <<'EOF'
{
  "data": {
    "v1.36.4-acp.3": "tkestack/baremetal-base-image:<os-image-tag-for-v4.5.0>",
    "v1.36.4-acp.3_etcd": "acp/k8s/etcd:v3.6.13-acp.5"
  }
}
EOF

ac -n cpaas-system get configmap elemental-image-catalog -o yaml

Registration file

alaudaos-m55-amd64.yaml
apiVersion: elemental.cattle.io/v1beta1
kind: MachineRegistration
metadata:
  name: alaudaos-m55-amd64
  namespace: cpaas-system
  labels:
    app.kubernetes.io/part-of: cluster-api-provider-baremetal
spec:
  # ${...} placeholders are expanded by elemental-register from SMBIOS data.
  machineName: "alaudaos-m55-amd64-${System Information/UUID}"
  machineInventoryLabels:
    app.kubernetes.io/part-of: cluster-api-provider-baremetal
    pool.baremetal.alauda.io/eligible: "true"
    elemental.cattle.io/serial-number: "${System Information/Serial Number}"
    # Architecture of the host, reported by elemental-register. Keep the value as is.
    os.baremetal.alauda.io/arch: "${Runtime/Architecture}"
    # OS identifier of the image this registration installs.
    os.baremetal.alauda.io/id: alaudaos.m.55
  machineInventoryAnnotations:
    elemental.cattle.io/machine-uuid: "${System Information/UUID}"
  config:
    elemental:
      install:
        # Each host reports its disks and waits until you select its system disk.
        device-selection: inventory
        eject-cd: true
        reboot: true
        snapshotter:
          type: btrfs
          maxSnaps: 4
      registration:
        # Each host uses its hardware TPM when usable, otherwise an emulated one.
        tpm-mode: auto
        emulated-tpm-seed: -1
---
apiVersion: elemental.cattle.io/v1beta1
kind: SeedImage
metadata:
  name: alaudaos-m55-amd64-iso
  namespace: cpaas-system
  labels:
    app.kubernetes.io/part-of: cluster-api-provider-baremetal
spec:
  type: iso
  baseImage: <registry-address>/tkestack/baremetal-base-image-iso:<os-image-tag-for-v4.5.0>
  registrationRef:
    apiVersion: elemental.cattle.io/v1beta1
    kind: MachineRegistration
    name: alaudaos-m55-amd64
    namespace: cpaas-system
  targetPlatform: linux/amd64
  size: 20Gi
  cleanupAfterMinutes: 120
  cloud-config:
    stages:
      boot:
        - name: "Size COS_STATE for reprovisioning"
          files:
            - path: /etc/elemental/config.d/partitions.yaml
              permissions: 0644
              content: |
                install:
                  partitions:
                    state:
                      size: 20480

Create the registration and build the ISO

alaudaos-m55-amd64
ac config use-cluster global
ac apply -f alaudaos-m55-amd64.yaml
ac -n cpaas-system wait --for=condition=SeedImageReady=True \
  seedimage/alaudaos-m55-amd64-iso --timeout=30m
ac -n cpaas-system get seedimage alaudaos-m55-amd64-iso \
  -o jsonpath='{.status.conditions[?(@.type=="SeedImageReady")].reason}{"\n"}{.status.downloadURL}{"\n"}{.status.checksumURL}{"\n"}'

推送 OS 映像

下载 ACP 版本中每个架构的 OS 归档文件;请参阅下载 Alauda OS。

以 root 身份运行推送 OS 映像,每个架构运行一个代码块,并且在满足以下条件的 Linux 主机上运行:

  • 可以访问注册表。
  • 已解压当前平台版本的 Core Package。该软件包的 packtool 还会推送更早 ACP 版本的归档文件。
  • /var/tmp 中的可用空间至少与归档文件大小相同。

在这些命令中,<extract-dir> 是解压后的 installer/ 目录,<host-arch> 是主机的架构,即 amd64 或 arm64。每个代码块会推送一个归档文件中的两个映像,然后列出注册表中两个仓库的标签。

  • 注册表中必须存在 tkestack 项目。
  • 使用有权推送到 tkestack 项目的注册表账户。
  • 不要使用 docker push 或其他会重写映像清单的工具进行推送,因为 Alauda OS KU 安装程序会完全按照归档文件中的原样读取清单。
  • 两个映像必须来自同一个归档文件。不要将来自不同归档文件的映像配对,也不要让集群资源指向构建注册表。
  • 对于使用专用注册表(cluster.registrySecretRef)的业务集群,还要将映像推送到该注册表,并使用其地址和账户。每次重新安装主机时,主机会从集群的注册表中拉取映像目录指定的 OS 映像;请参阅映像注册表。
  • 在两个 global 集群使用不同注册表的灾难恢复对中,将映像推送到两个注册表。

当每个 tags/list 响应都包含 OS 映像标签后再继续。否则,请检查注册表地址、凭据、tkestack 项目和推送输出。

添加映像目录键

映像目录会告知 provider 要在主机上安装哪个 OS 映像。在目录包含主机的 Kubernetes 版本、架构和 OS 所对应的键之前,主机会一直等待,不会进行安装。

选择 global 集群,然后运行添加映像目录键:

ac config use-cluster global
ac whoami --show-server

该命令会将键添加到映像目录中,保留现有键,并打印目录。当打印出的目录包含你添加的键后再继续。否则,请使用正确的值再次运行该命令。

在灾难恢复对中,映像目录不会同步。请为备用 global 集群再次运行该命令:使用 export KUBECONFIG=<standby-kubeconfig> 代替 ac config use-cluster global,然后运行 unset KUBECONFIG。

创建注册文件和 ISO

对于每个架构:

  1. 将注册文件保存为生成器显示的文件名,例如 alaudaos-m55-amd64.yaml。使用生成的文件。如果主机需要特定于站点的 DNS 设置才能在首次启动时注册,请将其添加到 MachineRegistration.spec.config.cloud-config。不要将 /etc/resolv.conf 添加到 SeedImage.spec.cloud-config。
  2. 运行创建注册文件并构建 ISO。该命令会将文件应用到 global 集群,等待 ISO 构建完成,并打印三行内容:构建结果、ISO 的下载 URL,以及其校验和的 URL。

当第一行是 SeedImageBuildSuccess 且两个 URL 均不为空时再继续。然后下载 ISO 并进行验证。

验证 ISO

校验和文件包含 ISO 的 SHA-256 哈希值和原始文件名。原始名称包含冒号,而 Windows 不允许文件名中包含冒号。因此,保存的文件通常会使用其他名称,sha256sum -c 无法找到该文件。请改为比较哈希值:

curl -sSk <checksum-url> | awk '{print $1}'    # expected hash
sha256sum <saved-iso-file> | awk '{print $1}'  # actual hash

当两个哈希值相同时再继续。否则,请重新下载 ISO。在 Windows 上,certutil -hashfile <saved-iso-file> SHA256 会打印实际哈希值。

重新构建 ISO

在 cleanupAfterMinutes 之后,URL 会被清除,但 SeedImageReady 可能仍为 True。请在下载 ISO 前再次检查原因。要获取新 URL,请删除 SeedImage,然后再次应用该文件:

ac config use-cluster global
ac -n cpaas-system delete seedimage <name>-iso
ac apply -f <name>.yaml

然后重复创建注册文件并构建 ISO中的 wait 和 get 命令。如果不再有 <name>.yaml,请按照生成命令中的说明,使用相同的 ACP 版本和 OS 映像标签重新生成。

已经从旧 ISO 启动的主机会继续注册。请从新 ISO 启动其余主机。

后续步骤