创建本地集群
目录
前提条件
节点要求
- 如果您从下载安装包下载了单架构安装包,请确保节点机器的架构与安装包一致,否则节点因缺少对应架构镜像无法启动。
- 验证节点操作系统和内核是否受支持,详情请参见支持的操作系统和内核。
- 对节点机器进行可用性检查,具体检查项请参考节点预处理 > 节点检查。
- 如果节点机器 IP 无法通过 SSH 直接访问,需要为节点提供 SOCKS5 代理,
global集群将通过该代理服务访问节点。
负载均衡
生产环境中,集群控制平面节点需要负载均衡器以保证高可用性。 您可以提供自有硬件负载均衡器,或启用“自建 VIP”,该方案通过 haproxy + keepalived 实现软件负载均衡。 推荐使用硬件负载均衡器,原因如下:
- 性能更优:硬件负载均衡性能优于软件负载均衡。
- 复杂度更低:如果不熟悉 keepalived,配置错误可能导致集群不可用,排查耗时且严重影响集群可靠性。
使用自有硬件负载均衡器时,可将负载均衡器的 VIP 作为“IP 地址 / 域名”参数;如果有解析到负载均衡器 VIP 的域名,也可使用该域名作为参数。 注意:
- 负载均衡器必须正确转发流量至集群所有控制平面节点的端口
6443、11780和11781。 - 如果集群仅有一个控制平面节点,且使用该节点 IP 作为“IP 地址 / 域名”参数,则无法后续将单节点集群扩展为高可用多节点集群,建议即使是单节点集群也提供负载均衡器。
启用“自建 VIP”时,需准备:
- 可用的 VRID
- 支持 VRRP 协议的主机网络
- 所有控制平面节点与 VIP 必须处于同一子网,且 VIP 不得与任何节点 IP 相同。
连接 global 集群与业务集群
平台要求 global 集群与业务集群之间互通访问。若不在同一网络,需要:
- 为业务集群提供“外部访问”,确保
global集群可访问业务集群。网络要求保证global可访问所有控制平面节点的端口6443、11780和11781。 - 为
global集群添加业务集群可访问的额外地址。创建业务集群时,将该地址以键cpaas.io/platform-url和对应的global公共访问地址作为值添加至集群注解。
镜像仓库
集群镜像支持平台内置、私有仓库和公共仓库三种选项。
- 平台内置:使用
global集群提供的镜像仓库。若集群无法访问global,请参见为内置仓库添加外部地址。 - 私有仓库:使用您自建的镜像仓库。推送所需镜像至私有仓库的具体操作,请联系技术支持。
- 公共仓库:使用平台公共镜像仓库。使用前请完成更新公共仓库凭据。
容器网络
若计划使用 Kube-OVN 的 Underlay 模式,请参考准备 Kube-OVN Underlay 物理网络。
创建操作步骤
-
进入 管理员 视图,点击左侧导航栏的 集群/集群。
-
点击 创建集群。
-
按照以下说明配置基本信息、容器网络、节点设置和扩展参数。
基本信息
容器网络
Kube-OVN 是由 Alauda 开发的企业级云原生 Kubernetes 容器网络编排系统。它将 OpenStack 领域成熟的网络能力引入 Kubernetes,支持跨云网络管理、传统网络架构与基础设施互联、边缘集群部署场景,同时大幅提升 Kubernetes 容器网络的安全性、管理效率和性能。
节点设置
节点添加参数
扩展参数
注意:
-
除必填配置外,不建议设置扩展参数,错误配置可能导致集群不可用,且集群创建后无法修改。
-
若输入的 Key 与默认参数 Key 重复,则覆盖默认配置。
操作步骤
- 点击 扩展参数 展开扩展参数配置区域。可选设置以下集群扩展参数:
- 点击 创建。页面将返回集群列表,集群状态为 创建中。
创建后操作
查看创建进度
在集群列表页面,可查看已创建集群列表。处于 创建中 状态的集群,可查看执行进度。
操作步骤
-
点击集群状态右侧的小图标 查看执行进度。
-
弹出的执行进度对话框中,可查看集群执行进度(status.conditions)。
提示:当某类型处于进行中或失败且带有原因时,将鼠标悬停在对应原因(蓝色文字)上,可查看原因详细信息(status.conditions.reason)。
关联项目
集群创建完成后,可在项目管理视图中将其添加至项目。