KubeSphere 和 Kubernetes 集群卸载、重装完全指南

本文是一篇实战短文,重点指导您成功卸载已有的 KubeSphere 和 Kubernetes 集群,并在原有服务器上完成重新部署。

实战服务器配置(架构1:1复刻小规模生产环境,只是配置略有不同)

主机名IPCPU内存系统盘数据盘用途
ksp-control-1192.168.9.16181640100KubeSphere/k8s-control-plane
ksp-control-2192.168.9.16281640100KubeSphere/k8s-control-plane
ksp-control-3192.168.9.16381640100KubeSphere/k8s-control-plane
ksp-storage192.168.9.1642440500NFS-Storage
合计42652160800

实战环境涉及软件版本信息

  • 操作系统:openEuler 22.03 LTS SP3 x86_64
  • KubeSphere:v4.1.2
  • Kubernetes:v1.30.6
  • KubeKey:  v3.1.7

1. 前言

本文适用于以下场景:

  • 部署 KubeSphere 和 Kubernetes 集群失败,需要在原有服务器上重新部署
  • 已有 KubeSphere 和 Kubernetes 集群,需要卸载后在原有服务器上重新部署

注意: 卸载 KubeSphere 和 Kubernetes 意味着将其从您的机器上移除。该操作不可逆,且不会进行任何备份。请谨慎操作

说明: 本文介绍的 Kubernetes 卸载方式仅适用于 Kubernetes 通过 KubeKey 安装的场景。如果您的 Kubernetes 不是通过 KubeKey 安装,请参阅 Kubernetes 官方文档[1]卸载 Kubernetes。

KubeSphere v3 和 v4 卸载 KubeSphere 和 Kubernetes 集群方式略有不同,本文分别介绍。

2. KubeSphere v3.x 操作指南

KubeSphere v3.x 如需删除集群并重建,请执行以下相关命令。

2.1 卸载 KubeSphere 和 Kubernetes 集群

  • 进入部署集群时使用的 KubeKey 目录
cd /root/kubekey

如果是按照快速入门 All-in-One 安装的 KubeSphere

./kk delete cluster

如果是使用配置文件安装的 KubeSphere

./kk delete cluster -f config-sample.yaml

说明:  config-sample.yaml 是部署集群时的配置文件。

卸载成功会提示如下信息

21:56:19 CST Pipeline[DeleteClusterPipeline] execute successfully

2.2 清理未删除干净的信息

这一步是核心,很多部署失败都是因为残留的配置未清理干净。

  • 进入部署集群时使用的 KubeKey 目录,查看数据
cd /root/kubekey
$ ls
kk  ksp-k8s-v1306.yaml  kubekey  kubekey-v3.1.7-linux-amd64.tar.gz

查看 kubekey 目录的数据

$ ls /root/kubekey/kubekey
cni  config-opsxlab  containerd  crictl  etcd  helm  ksp-control-1  ksp-control-2  ksp-control-3  kube  logs  pki  runc

删除 pki 和以节点名命名的所有目录(建议做好备份

cd /root/kubekey/kubekey
rm -rf ksp-control-1  ksp-control-2  ksp-control-3 pki

3. KubeSphere v4.x 操作指南

KubeSphere v4.x 如需删除集群并重建,请执行以下相关命令。

3.1 卸载 KubeSphere

KubeSphere v4 的部署方式采用了 Helm,所以卸载时需要使用 Helm。

helm -n kubesphere-system uninstall ks-core

3.2 卸载扩展组件

可选操作,上面的操作只是卸载了 KubeSphere Core,如果您安装了扩展组件,还需要手工卸载扩展组件。

  • 查看通过 Helm 安装的扩展组件
$ helm list -A
NAME                            NAMESPACE                       REVISION        UPDATED                                 STATUS          CHART                    APP VERSION
ks-core                         kubesphere-system               1               2024-11-08 09:16:57.860023524 +0800 CST deployed        ks-core-1.1.3            v4.1.2
whizard-monitoring              kubesphere-monitoring-system    1               2024-11-08 03:10:46.242966821 +0000 UTC deployed        whizard-monitoring-1.1.1  
whizard-monitoring-agent        kubesphere-monitoring-system    1               2024-11-08 03:14:36.072353417 +0000 UTC deployed        whizard-monitoring-1.1.1  
whizard-telemetry               extension-whizard-telemetry     1               2024-11-08 03:01:26.269210475 +0000 UTC deployed        whizard-telemetry-1.2.2   

卸载扩展组件(以监控组件为例,其它组件类似

helm -n kubesphere-monitoring-system uninstall whizard-monitoring whizard-monitoring-agent
# helm -n extension-whizard-telemetry uninstall whizard-telemetry

3.3 卸载 Kubernetes 集群

  • 进入部署集群时使用的 KubeKey 目录
cd /root/kubekey

如果是按照快速入门 All-in-One 安装的 Kubernetes

./kk delete cluster

如果是使用配置文件安装的 Kubernetes

./kk delete cluster -f config-sample.yaml

说明:  config-sample.yaml 是部署集群时的配置文件。
卸载成功会提示如下信息

21:56:19 CST Pipeline[DeleteClusterPipeline] execute successfully

3.4 清理未删除干净的信息

这一步是核心,很多部署失败都是因为残留的配置未清理干净。

  • 进入部署集群时使用的 KubeKey 目录,查看数据
cd /root/kubekey
$ ls

kk  ksp-k8s-v1306.yaml  kubekey  kubekey-v3.1.7-linux-amd64.tar.gz

查看 kubekey 目录的数据

$ ls /root/kubekey/kubekey
cni  config-opsxlab  containerd  crictl  etcd  helm  ksp-control-1  ksp-control-2  ksp-control-3  kube  logs  pki  runc

删除 pki 和以节点名命名的所有目录(建议做好备份

cd /root/kubekey/kubekey
rm -rf ksp-control-1  ksp-control-2  ksp-control-3 pki

4. 重新部署 KubeSphere 和 Kubernetes 集群

参考下面的部署文档,重新部署 KubeSphere 和 Kubernetes 集群。

征服 Docker 镜像访问限制 KubeSphere v3.4.1 成功部署全攻略

33 张高清大图,带你玩转 KubeSphere v4.1.2 部署与扩展组件安装

理论上不会再失败,如有问题可以在评论区留言,或是加我wx 「opsxlab」,邀您入群一起探讨本文的知识点。

以上,就是我今天分享的全部内容。下一期分享的内容还没想好,敬请期待开盲盒

声明: 本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

给TA打赏
共{{data.count}}人
人已打赏
Kubernetes

解决 Kubernetes 节点上的挂载点卡住问题:一次深入探索

2024-11-26 14:44:43

Kubernetes

Kubernetes CoreDNS 无法解析外网域名的问题

2024-12-3 7:49:33

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索