先决条件

在任何 provider 上安装 global 集群之前,请完成以下准备工作。每个 provider 还会在其先决条件页面中列出特定要求。

当 global 集群的节点在裸金属、Huawei DCS、VMware vSphere 或 Huawei Cloud Stack 上运行 Alauda OS 时,适用此安装路径。对于 Ubuntu 或 RHEL 等非 Alauda OS,请改用在非 Alauda OS 上安装。

通用先决条件

首先按照准备资源中的说明,准备每次安装所需的资源:安装包、已上传有效负载的外部平台镜像 Registry、平台域名,以及您自己的证书(如果使用)。此安装路径不支持平台内置的 Registry。

在 Alauda OS 上,还需准备以下内容:

  • 符合Bootstrap Node要求的 Bootstrap Node。 灾难恢复部署需要在两侧各准备一个 Bootstrap Node。
  • 为此版本发布的 Alauda OS 镜像。 按照 provider 的先决条件说明,为节点准备该镜像。
  • 端口为 6443 的稳定控制平面端点。 该端点可以是外部负载均衡器或自建 VIP;请参阅规划控制平面端点。在 Huawei Cloud Stack 上,provider 会创建一个 ELB;请参阅其先决条件。
  • 在 Huawei DCS、VMware vSphere 和 Huawei Cloud Stack 上,为每个节点准备一个静态 IPv4 地址和一个主机名。 provider 会将其分配给所创建的虚拟机。请参阅 provider 的先决条件。
  • 对于 x86_64 节点, CPU 必须支持 x86-64-v2 ISA 基线。请参阅OS 支持矩阵。

如果您使用自己的证书作为平台访问地址的证书,请将其文件放在 Bootstrap Node 上:PEM 证书和私钥,或 PKCS#12 捆绑包。install-config.yaml 通过绝对路径引用这些文件。

Bootstrap Node

Bootstrap Node 是一台临时机器。它运行 ac,并在安装期间运行 Bootstrap 集群。它永远不会加入 global 集群。安装完成后,您可以回收这台机器;但在此之前,请参阅安装目录,了解需要保留的内容。

硬件

资源最低要求(x86_64)
CPU4 个核心
内存8 GB
磁盘300 GB 或更多,可供您提取 Core Package 的目录和 /var/cpaas 使用

对于 arm64,至少使用 6 个核心和 12 GB 内存。建议配置为 8 个核心和 16 GB 内存。

操作系统

使用任何带有 Bash 和 root 访问权限的 64 位 Linux 发行版。

准备 Bootstrap Node,使其满足以下条件。ac 使用 Core Package 中的 setup.sh 脚本启动 Bootstrap 集群,而 setup.sh 会首先检查这些条件:

  • 以 root 身份运行 ac。
  • 已禁用 Swap。swapon -s 不列出任何 Swap,并且 /etc/fstab 中没有包含 swap 的未注释行。
  • 如果安装了 AppArmor(例如在 Ubuntu 上),则已将其禁用。apparmor 服务既未处于活动状态,也未启用,并且 /sys/module/apparmor/parameters/enabled 不是 Y。
  • 未安装容器运行时。containerd 和 dockerd 不在 PATH 中。setup.sh 会安装 Bootstrap 集群使用的 containerd。
  • /etc/cni 不存在。
  • /etc/resolv.conf 存在,且最多包含两个 nameserver 条目。其中没有任何条目是环回地址,但 127.0.0.53 除外。

如果不满足某个条件,setup.sh 会在修改主机之前停止。修复该条件,然后再次运行 create,如 ac 的输出所示。请参阅常见故障。

网络

Bootstrap Node 需要一个在安装期间不会发生变化的静态 IP 地址。

允许通信矩阵为 Bootstrap Node 和 global 节点列出的网络流量,相关章节包括:安装、基础设施 provider 和镜像 Registry。

准备 Core Package 和 Registry

ac 在 Bootstrap Node 上运行,并读取其中已提取的 Core Package。在 Bootstrap Node 上执行以下步骤;对于灾难恢复对,在每一侧的 Bootstrap Node 上执行:

  1. 将 Core Package 上传到 Bootstrap Node 并将其提取。在本文档中,<extract-dir> 是已提取的 installer/ 目录。
  2. 按照下载中的说明,将 ACP Common Aligned Extensions 的所有软件包复制到 <extract-dir>/plugins/。
  3. 如果尚未将 payload 上传到外部 Registry,请按照准备目标版本 Payload中的说明,从 <extract-dir> 上传。对于每侧各有一个 Registry 的灾难恢复对,将其上传到两个 Registry。

Core Package 在 <extract-dir>/res/<arch>/ac 处包含 ac,其中 <arch> 为 amd64 或 arm64。安装页面会从该位置运行它。请将其保留在原位置;无需安装。

规划控制平面端点

每个集群都需要一个用于 Kubernetes API 的稳定端点。请在创建集群之前选择端点模式。

WARNING

集群创建后不要更改控制平面端点。端点属于 API server 证书、kubeconfig 以及与 global 集群的连接的一部分。

按 provider 划分的端点模式

Provider端点模式需要准备的内容
Huawei DCS外部负载均衡器(默认)或自建 VIP。外部负载均衡器:在创建集群之前准备负载均衡器。自建 VIP:控制平面二层网络中的 IPv4 VIP,以及在该二层域中唯一的 VRID。
VMware vSphere外部负载均衡器(默认)或自建 VIP。外部负载均衡器:在创建集群之前准备负载均衡器。自建 VIP:IPv4 VIP、一个端口(通常为 6443),以及在控制平面二层域中唯一的 VRID。
裸金属自建 VIP(默认)或外部负载均衡器。自建 VIP:一个未占用的 VIP、一个端口(通常为 6443),以及在控制平面二层域中唯一的 VRID。外部负载均衡器:在创建集群之前准备负载均衡器。
Huawei Cloud Stack由 provider 创建的 HCS ELB。ELB 地址:VIP、两个 L4 地址和两个 L7 地址。请参阅控制平面 ELB 地址。

如果不选择模式,则使用默认模式。在 install-config.yaml 中设置模式及其值;请参阅相应 provider 的模板:裸金属、Huawei DCS 或 VMware vSphere。

在 VMware vSphere 上,集群只有在创建时使用自建 VIP,才能使用自建 VIP。其 provider 从早期版本升级而来的集群会继续使用外部负载均衡器。请参阅控制平面端点模式。

外部负载均衡器

请在创建集群之前配置负载均衡器。它必须满足外部负载均衡器要求。

创建前检查侦听器

在 global 集群的某个节点上运行此命令;对于 global 安装,则在 Bootstrap Node 上运行:

nc -vz <control-plane-endpoint> 6443
结果操作
succeeded 或 open继续。
连接被拒绝或超时在负载均衡器的管理界面中确认 <control-plane-endpoint>:6443 上存在 TCP 侦听器,然后继续。某些负载均衡器仅在后端运行正常后才接受连接。

自建 VIP

  • 在与将持有 VIP 的控制平面接口相同的二层网络中预留一个未使用的 IPv4 地址。
  • 使用 1 到 255 范围内、且在该二层域中唯一的 VRID。
  • 允许控制平面节点与周围网络之间的 VRRP 流量和免费 ARP 更新;请参阅自建 VIP。
  • 至少使用三个控制平面节点以实现高可用性。
  • 对于自建 VIP,请使用 IP 地址,而不是域名。
  • 不要手动为同一 VIP 维护第二个后端列表。替换控制平面节点时,provider 会更新后端列表。
  • 如果为 VIP 接口命名,请使用长度不超过 15 个字符的 Linux 接口名称,例如 eth0。如果未命名,VIP 将保留在具有节点地址的接口上。

在 Huawei DCS 上,端口组允许 VIP 所有权、免费 ARP 和 VRRP 流量。

在 VMware vSphere 上,还适用以下规则:

  • VIP 必须为 IPv4。不接受 IPv6 和双栈端点。
  • VIP 不得等于任何节点地址(包括主地址或附加地址)。此外,VIP 必须位于每个外部 IPAM 池范围之外,因为 provider 不会检测与外部 IPAM 池的冲突。
  • 对于具有多个 NIC 的节点,请显式命名 VIP 接口。集群创建后无法更改该接口。
  • dvPortGroup 安全策略和任何 NSX-T 分布式防火墙规则都必须允许控制平面节点之间的 VRRP(IP 协议 112,组播 224.0.0.18)和免费 ARP。

后续步骤

现在,您已有:

  • 外部 registry 地址和凭据。
  • 平台访问地址。
  • 用户提供的证书(如果使用)。
  • 控制平面端点。

继续阅读您的 provider 概述。该概述介绍了在该 provider 上的安装方式,并按顺序列出了剩余步骤。然后完成您的 provider 的先决条件并创建集群:

对于主集群和备用集群(类型为 global),请先阅读创建 Global 集群灾难恢复对,再编写任一 install-config.yaml。