前置要求

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

INFO
  1. 当前平台不支持直接在现有 Kubernetes 环境中安装 global 集群。如果您的环境中已经存在 Kubernetes 集群,请在安装前备份数据并清理环境。
  2. 如果您计划使用 global 集群灾难恢复,请先阅读 global 集群灾难恢复。
  3. 确保所有新节点均满足节点要求。
  4. 磁盘的性能和容量也必须满足磁盘配置要求。

资源规划

本节介绍安装 前进行资源规划的指导原则。 请根据您的环境和使用需求选择合适的部署场景,并相应地准备资源。

INFO

以下建议仅涵盖成功安装 Global 集群 所需的最小资源。

其中不包括在 Global 集群上部署的任何额外扩展或组件所需的资源。

有关各个扩展的详细要求,请参阅相应的组件文档。

部署架构

WARNING

对于 ARM 架构(例如 Kunpeng 920),建议将配置提升至 x86 最低配置的 2 倍,但不得低于 1.5 倍。

例如:如果 x86 需要 8 核 16GB,则 ARM 至少应达到 12 核 24GB,建议配置为 16 核 32GB。

安装前,您必须确定最适合您使用场景的部署架构。 支持以下三种常见的部署架构:

  • 多集群

    如果您需要集中管理多个 Kubernetes 集群,请选择此架构。 在此模式下, 由一个 Global 集群和多个业务集群组成。 在 Global 集群上运行非平台业务负载可能会降低平台的稳定性和性能,应予以避免。

  • 单集群

    如果您计划仅安装一个集群并直接在其上运行业务负载,请选择此架构。 在此模式下,Global 集群同时充当业务集群,因此与多集群模式下纯 Global 集群的部署相比,需要更多资源。

  • 单节点

    WARNING

    此架构仅用于测试或概念验证,不应在生产环境中使用。

单节点

下表列出了以单节点模式安装 的最低硬件要求。

资源最低要求
CPU12 核
内存24GB
存储存储容量

单集群

在此模式下,Global 集群同时充当控制平面和业务集群。 Global 集群的控制平面节点数必须为 3。

总资源要求由两部分组成:

  • Global 集群自身所需的基础资源
  • 在同一集群上运行业务负载所需的额外资源

高可用 Global 集群所需的资源如下:

资源最低要求
CPU8 核
内存16GB
存储存储容量

要估算业务负载所需的额外资源,请参阅 评估业务集群资源

多集群

管理多个业务集群时,Global 集群的资源使用量会随着所管理集群数量的增加而按比例增加。 额外开销主要来自集群注册、监控和控制平面同步。

要根据所管理集群的数量估算 Global 集群所需的资源,请参阅评估 Global 集群资源

网络

在安装之前,请确保已准备好所需的网络资源。

如果您的环境中有可用的硬件 LoadBalancer,建议使用它。如果没有,您可以启用 Self-built VIP,通过 keepalived 提供软件负载均衡。

注意:Self-built VIP 不支持域名配置。

网络资源

资源必需数量描述
global VIP必需1用于集群中的节点访问 kube-apiserver,需要在负载均衡设备中进行配置以确保高可用。
此 IP 也可用作平台 Web UI 的访问地址。
与 global 集群处于同一网络中的业务集群,也可以通过此 IP 访问 global 集群。
外部 IP可选按需当存在与 global 集群不在同一网络中的业务集群时(例如混合云场景),必须提供此 IP。其他网络中的业务集群通过此 IP 访问 global 集群。
需要在负载均衡设备中配置此 IP,以确保高可用。
此 IP 也可用作平台 Web UI 的访问地址。
域名建议按需

建议将其用于集群端点和平台访问地址。请提前提供域名,并确保域名解析正确。

建议使用域名,因为如果在集群安装后需要更改 VIP,您可以轻松更新 DNS 记录,而不会影响集群运行。

在以下情况下,必须使用域名:

  • global 集群需要支持 IPv6 访问;
  • 计划为 global 集群制定灾难恢复方案。
证书可选按需建议使用受信任的证书,以避免浏览器安全警告;如果未提供证书,安装程序将生成自签名证书,但使用 HTTPS 时可能存在安全风险。
NOTE

如果平台需要配置多个访问地址(例如内部网络和外部网络的地址),请根据上表提前准备相应的 IP 地址或域名。您可以稍后在安装参数中配置这些地址,也可以在安装后根据产品文档添加这些地址。

网络配置

类型要求说明
网络带宽集群内带宽必须 ≥1 Gbps(建议 10 Gbps)。
跨集群带宽必须 ≥100 Mbps(建议 1 Gbps)。
带宽不足可能会显著降低数据查询性能。
网络延迟集群内延迟必须 ≤10 ms。
跨集群延迟必须 ≤100 ms(建议 ≤30 ms)。
网络策略请参阅LoadBalancer 转发规则,确保必要的端口已开放。
IP 地址范围global 集群节点应避免使用 172.17-18 网段。如果已使用,请调整 nerdctl 配置(添加 bip 参数)以避免冲突。

LoadBalancer 转发规则

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

源 IP协议目标 IP目标端口描述
global VIP、外部 IPTCP所有控制平面节点 IP443

通过 HTTPS 协议为平台 Web UI、镜像仓库和 Kubernetes API Server 提供访问服务。默认端口为 443。如果需要使用自定义 HTTPS 端口,请执行以下操作:

  • 将端口转发规则中的目标端口替换为自定义端口号。
  • 稍后在 Web UI 安装参数中填写自定义端口号。
global VIP、外部 IPTCP所有控制平面节点 IP6443

此端口为集群内的节点提供 Kubernetes API Server 访问服务。

global VIP、外部 IPTCP所有控制平面节点 IP11443

此端口为集群内的节点提供镜像仓库访问服务。
注意:如果计划使用外部平台镜像仓库,而不是使用 global 集群提供的 Registry,则无需配置此端口。有关外部 Registry 的网络要求,请参阅准备外部平台镜像仓库。

TIP
  • 建议在 LoadBalancer 上配置健康检查,以监控端口状态。
  • Global 集群灾难恢复要求在两个集群 VIP 上配置负载均衡器监听器,并确保 Primary 集群网络与 Standby 集群网络之间能够双向访问。请参阅网络要求。
  • 平台默认仅支持 HTTPS。如果需要支持 HTTP,则需要为所有控制平面节点开放 HTTP 端口。

外部平台镜像仓库

对于新的生产部署,如果组织要求独立管理镜像仓库的可用性、容量、备份和生命周期,请准备一个由客户管理的外部平台镜像仓库。

运行 setup.sh 之前,请完成准备外部平台镜像仓库。该页面定义了所需的地址、网络访问、存储以及推送和拉取权限;区分了这些要求与生产建议;并说明了如何上传完整的目标版本负载。