先决条件
在任何 provider 上安装 global 集群之前,请完成以下准备工作。每个 provider 还会在其先决条件页面中列出特定要求。
当 global 集群的节点在裸金属、Huawei DCS、VMware vSphere 或 Huawei Cloud Stack 上运行 Alauda OS 时,适用此安装路径。对于 Ubuntu 或 RHEL 等非 Alauda OS,请改用在非 Alauda OS 上安装。
目录
通用先决条件Bootstrap Node硬件操作系统网络准备 Core Package 和 Registry规划控制平面端点按 provider 划分的端点模式外部负载均衡器创建前检查侦听器自建 VIP后续步骤通用先决条件
首先按照准备资源中的说明,准备每次安装所需的资源:安装包、已上传有效负载的外部平台镜像 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-v2ISA 基线。请参阅OS 支持矩阵。
如果您使用自己的证书作为平台访问地址的证书,请将其文件放在 Bootstrap Node 上:PEM 证书和私钥,或 PKCS#12 捆绑包。install-config.yaml 通过绝对路径引用这些文件。
Bootstrap Node
Bootstrap Node 是一台临时机器。它运行 ac,并在安装期间运行 Bootstrap 集群。它永远不会加入 global 集群。安装完成后,您可以回收这台机器;但在此之前,请参阅安装目录,了解需要保留的内容。
硬件
对于 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 上执行:
- 将 Core Package 上传到 Bootstrap Node 并将其提取。在本文档中,
<extract-dir>是已提取的installer/目录。 - 按照下载中的说明,将 ACP Common Aligned Extensions 的所有软件包复制到
<extract-dir>/plugins/。 - 如果尚未将 payload 上传到外部 Registry,请按照准备目标版本 Payload中的说明,从
<extract-dir>上传。对于每侧各有一个 Registry 的灾难恢复对,将其上传到两个 Registry。
Core Package 在 <extract-dir>/res/<arch>/ac 处包含 ac,其中 <arch> 为 amd64 或 arm64。安装页面会从该位置运行它。请将其保留在原位置;无需安装。
规划控制平面端点
每个集群都需要一个用于 Kubernetes API 的稳定端点。请在创建集群之前选择端点模式。
集群创建后不要更改控制平面端点。端点属于 API server 证书、kubeconfig 以及与 global 集群的连接的一部分。
按 provider 划分的端点模式
如果不选择模式,则使用默认模式。在 install-config.yaml 中设置模式及其值;请参阅相应 provider 的模板:裸金属、Huawei DCS 或 VMware vSphere。
在 VMware vSphere 上,集群只有在创建时使用自建 VIP,才能使用自建 VIP。其 provider 从早期版本升级而来的集群会继续使用外部负载均衡器。请参阅控制平面端点模式。
外部负载均衡器
请在创建集群之前配置负载均衡器。它必须满足外部负载均衡器要求。
创建前检查侦听器
在 global 集群的某个节点上运行此命令;对于 global 安装,则在 Bootstrap Node 上运行:
自建 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。