#前提条件

在安装 global 集群之前，您需要准备符合要求的硬件、网络和操作系统环境。

#容量规划

安装前，您必须根据目标和实际需求选择合适的安装场景。不同场景在基础设施资源配置和架构设计要求上存在较大差异。以下是三种典型场景的规划建议：

#机器

#基本要求

集群至少需提供 3 台物理机或虚拟机作为控制平面节点。每个节点的最低配置如下：

类别	最低要求
CPU	≥ 8 核，主频 ≥ 2.5GHz 禁止超分配；关闭节能模式
内存	≥ 16GB 禁止超分配；建议使用至少六通道 DDR4
硬盘	单设备 IOPS ≥ 2000 吞吐量 ≥ 200MB/s 必须使用 SSD

#ARM 架构要求

对于 ARM 架构（如 Kunpeng 920），建议配置提升至 x86 最低配置的 2 倍，但不少于 1.5 倍。

例如：x86 需 8 核 16GB，则 ARM 至少应达到 12 核 24GB，推荐配置为 16 核 32GB。

#支持的操作系统和内核

#网络

安装前，必须预先配置以下网络资源。如果无法提供硬件 LoadBalancer，安装程序支持配置 haproxy + keepalived 作为软件负载均衡，但需注意：

• 性能较差：软件负载均衡性能低于硬件 LoadBalancer。
• 复杂度较高：若不熟悉 keepalived，可能导致 global 集群不可用，故障排查耗时且严重影响平台可靠性。

#网络资源

资源	是否必需	数量	说明
global VIP	必需	1	用于集群内节点访问 kube-apiserver，配置于负载均衡设备以确保高可用。 该 IP 也可作为平台 Web UI 的访问地址。 与 global 集群处于同一网络的业务集群也可通过此 IP 访问 global 集群。
外部 IP	可选	按需	当存在与 global 集群不在同一网络的业务集群（如混合云场景）时，必须提供。其他网络的业务集群通过此 IP 访问 global 集群。 该 IP 需配置于负载均衡设备以确保高可用。 该 IP 也可作为平台 Web UI 的访问地址。
域名	可选	按需	若需通过域名访问 global 集群或平台 Web UI，请提前提供并确保域名解析正确。
证书	可选	按需	建议使用受信任证书以避免浏览器安全警告；若未提供，安装程序将生成自签名证书，但使用 HTTPS 时可能存在安全风险。

#网络配置

类型	需求说明
网络速率	global 集群与同网业务集群速率 ≥1Gbps（推荐 10Gbps）；跨网速率 ≥100Mbps（推荐 1Gbps）。 速率不足将显著降低数据查询性能。
网络延迟	同网延迟 ≤2ms；跨网延迟 ≤100ms（推荐 ≤30ms）。
网络策略	请参考LoadBalancer 转发规则确保必要端口开放；使用 Calico CNI 时，确保启用 IP-in-IP 协议。
IP 地址范围	global 集群节点应避免使用 172.16-32 网段。如已使用，请调整 Docker 配置（添加 bip 参数）以避免冲突。

#LoadBalancer 转发规则

该规则用于确保 global 集群能正常接收来自 LoadBalancer 的流量。请根据下表检查网络策略，确保相关端口开放。

源 IP	协议	目标 IP	目标端口	说明
global VIP，外部 IP	TCP	所有控制平面节点 IP	443	通过 HTTPS 协议为平台 Web UI、镜像仓库和 Kubernetes API Server 提供访问服务。默认端口为 443。若需使用自定义 HTTPS 端口，请执行以下操作： 在端口转发规则中将目标端口替换为自定义端口号。 后续在 Web UI 安装参数中填写自定义端口号。
global VIP，外部 IP	TCP	所有控制平面节点 IP	6443	该端口为集群内节点访问 Kubernetes API Server 提供服务。
global VIP，外部 IP	TCP	所有控制平面节点 IP	11443	该端口为集群内节点访问镜像仓库提供服务。 注意：若计划使用外部镜像仓库替代 global 集群默认镜像仓库，则无需配置此端口。