KubeKey 部署 CubeStudio 总览
本篇介绍用 KubeKey（命令行工具 kk）搭建 Kubernetes 集群，并在其上部署 CubeStudio 平台的完整流程。KubeKey 会自动为节点安装 containerd/docker、kubeadm、kubelet、kubectl、CNI、helm 等组件，适合需要快速拉起 k8s（含多机、离线、高可用）的场景。
本文档由以下源文件合并整理：
docs/部署/kubekey部署cube-studio.md、install/kubernetes/rancher/kubekey/kubekey部署cube-studio.md、install/kubernetes/rancher/kubekey/kubekey离线部署k8s.md、install/kubernetes/rancher/kubekey/kubekey高可用.md。
适用与前置
- 机器最低规格：16C32G；之前装过 KubeSphere(KS) 的环境要先清理干净。
- 容器运行时可选 docker 或 containerd（KubeKey 自动安装，节点无需手工预装）。如需手工了解运行时配置，参考《节点安装 Containerd 容器运行时》。
- 部署前的机器/存储/网络检查清单见《部署总览与前置要求》。
- KubeKey 版本：
v3.1.10；可安装 k8sv1.25.16（配置文件方式，见仓库install/kubernetes/rancher/kubekey/config-cluster.yaml）或v1.28.15（命令行直建方式）。
子文档目录（TOC）
| 文件 | 内容 |
|---|---|
| 01-环境准备与安装k8s.md | 每台机器的系统初始化、下载 KubeKey、在线安装 k8s（命令行直建 / 配置文件多机两种方式）、常见报错 |
| 02-部署cube-studio.md | 在 k8s 上部署平台：NodePort 端口范围、containerd 下 nerdctl 替换、ipvs 模式 istio 入口、kubeconfig 与 start.sh、Prometheus 切换为 KubeSphere |
| 03-离线部署.md | 内网离线场景：所需镜像列表、制作离线包（artifact export）、离线启动与创建集群 |
| 04-节点扩缩容与高可用.md | 增删节点、升级配置、高可用 master 增删（含 etcd 成员移除）、卸载与彻底清理 |
整体流程一览
- 每台机器做系统初始化（主机名、时间同步、基础依赖、关防火墙/swap）——见 01。
- 下载 KubeKey，安装 k8s（在线命令行或配置文件方式；离线见 03）——见 01。
- 在 k8s 上部署 CubeStudio（端口范围、运行时适配、入口、Prometheus）——见 02。
- 后续运维：扩缩容 / 升级 / 高可用 / 卸载——见 04。
部署后的排查方法可参考《部署验证》与《常见问题 FAQ》。