创建本地集群
前提条件
节点要求
- 如果您从下载安装包下载了单架构安装包,请确保节点机器的架构与安装包一致。否则,由于缺少对应架构的镜像,节点将无法启动。
- 请确认节点操作系统和内核受支持。详情请参见支持的 OS 和内核。
- 对节点机器执行可用性检查。具体检查项请参见节点预处理 > 节点检查。
- 如果节点机器 IP 无法通过 SSH 直接访问,请为节点提供 SOCKS5 代理。
global集群将通过该代理服务访问节点。
负载均衡
对于生产环境,集群控制平面节点需要负载均衡器,以确保高可用。
如果您的环境中已有硬件负载均衡器,建议使用它。
如果没有,可以启用 Self-built VIP,它使用 keepalived 提供软件负载均衡能力。
建议:使用硬件负载均衡器时,建议将集群 Endpoint 配置为域名。如果集群安装后硬件负载均衡器的 VIP 发生变化,您可以更新 DNS 记录,而无需重新配置集群。
注意:Self-built VIP 不支持域名配置。
负载均衡器必须能够正确转发到集群中所有控制平面节点上的 6443、11780 和 11781 端口。
如果您的集群只有一个控制平面节点,并且使用该节点的 IP 作为 Cluster Endpoint 参数,那么后续无法从单节点扩展为高可用的多节点部署。因此,即使是单节点集群,我们也建议提供负载均衡器。
启用 Self-built VIP 时,您需要准备:
- 一个可用的 VRID
- 支持 VRRP 协议的主机网络
- 所有控制平面节点和 VIP 必须位于同一子网中,且 VIP 不能与任何节点 IP 重复
连接 global 集群和业务集群
平台要求 global 集群与业务集群之间能够相互访问。如果它们不在同一网络中,您需要:
- 为业务集群提供
External Access,以确保global集群可以访问它。网络要求必须确保global能够访问所有控制平面节点上的6443、11780和11781端口。 - 为
global添加一个业务集群可访问的额外地址。创建业务集群时,请将该地址添加到集群注解中,键为cpaas.io/platform-url,值设置为global的公网访问地址。
镜像仓库
集群镜像支持 Platform Built-in、Private Repository 和 Public Repository 选项。这些选项用于配置业务集群使用的平台镜像源。
- Platform Built-in:使用为
global集群配置的平台镜像源。该镜像源可以是随global部署的 Registry,也可以是安装过程中选择的外部平台镜像仓库。如果镜像源是内置 Registry 且业务集群无法访问global,请参见为内置 Registry 添加外部地址。 - Private Repository:为该业务集群使用其他由客户管理的镜像仓库。在选择之前,请上传所选 Kubernetes 版本和架构所需的完整镜像内容,并满足准备外部平台镜像仓库中描述的能力和访问条件。用于生产时,还应遵循 HTTPS、DNS、可用性、监控、备份、恢复和保留方面的生产建议。
- Public Repository:使用平台的公共镜像仓库。使用前,请完成更新公共仓库凭据。
容器网络
如果您计划在集群中使用 Kube-OVN 的 Underlay,请准备Kube-OVN Underlay 物理网络。
创建步骤
-
进入管理员视图,然后在左侧导航栏中单击 Clusters/Clusters。
-
单击 Create Cluster。
-
按照以下说明配置各个部分:Basic Info、Container Network、Node Settings 和 Extended Parameters。
基本信息
容器网络
Kube-OVN 是由 开发的云原生 Kubernetes 容器网络编排系统。它为跨云网络管理、传统网络架构集成、基础设施互联以及边缘集群部署场景提供 Kubernetes 网络能力。
节点设置
添加节点参数
扩展参数
注意:
-
除必需配置外,不建议设置扩展参数,因为错误的设置可能会导致集群不可用,并且在集群创建后无法修改。
-
如果输入的 Key 与默认参数 Key 重复,则会覆盖默认配置。
操作步骤
- 单击 Extended Parameters 以展开扩展参数配置区域。您可以为集群选择性设置以下扩展参数:
- 单击 Create。您将返回集群列表页面,集群状态将显示为 Creating。
创建后步骤
查看创建进度
在集群列表页面,您可以查看已创建集群的列表。对于处于 Creating 状态的集群,您可以查看其执行进度。
操作步骤
-
单击集群状态右侧的 View Execution Progress 小图标。
-
在弹出的执行进度对话框中,您可以查看集群的执行进度(status.conditions)。
提示:当某个类型处于进行中状态,或者在失败状态下带有原因时,将鼠标悬停在对应原因(蓝色文本)上,可查看该原因的详细信息(status.conditions.reason)。
关联项目
集群创建完成后,您可以在项目管理视图中将其添加到项目中。