集群卸载总览 ​

本文是openFuyao集群卸载的统一入口，说明删除顺序、影响范围、操作节点及各命令会删除哪些内容。具体步骤见下文各子文档。

危险：
卸载与删除为高危操作，执行前请确认目标集群、命名空间与资源名称，并完成必要备份。误删后可能无法通过管理面继续纳管或卸载其他集群。

推荐删除顺序 ​

请按以下顺序卸载，不要在仍有业务/管理集群依赖时先卸载引导集群：

业务集群 → 管理集群（若有） → 引导集群

表1 推荐删除顺序

注意：
不能在业务/管理集群尚未卸载时直接删除引导集群。卸载引导集群后：

• openFuyao引导节点管理面将无法登录。
• 无法再通过管理面或引导节点上的 bc 对业务/管理集群执行卸载。
• 残留的业务/管理集群节点需另行登录各节点手工清理，风险高。

操作节点与入口 ​

表2 卸载操作节点与入口

删除方式与清理范围 ​

1. 业务/管理集群（通过BKECluster） ​

在引导或管理集群上编辑目标bc，配置说明如下：

表3 BKECluster卸载配置说明

**完整卸载目标集群（推荐后台步骤）**需同时满足：将ignore-target-cluster-delete设为"false"，并设置spec.reset: true。仅删除API/bc对象而不清理节点时，可保持默认注解为"true"。

说明：
管理集群安装时节点代理bkeagent前期侦听引导集群，之后会切换为侦听管理集群自身，因此卸载管理集群时须分别处理引导集群与管理集群两侧（前台两侧列表删除，或后台两侧bc），详见具体指导文档。

卸载过程中，控制器会按依赖逆序清理addon、Kubernetes组件、etcd等；失败时bc可能进入终止失败类状态，需结合kubectl describe bc排查。

2. 引导集群（bke reset） ​

表4 bke reset命令清理范围

说明：

• bke reset不会自动解绑高可用场景下已绑定的虚拟IP（VIP）；若节点上仍残留VIP，需手工ip addr del，参见FAQ。
• rm -rf /bke、rm -f /usr/local/bin/bke 为可选清理步骤，用于删除安装介质目录与bke命令；非必须。未执行也可认为引导服务已重置，但再次安装时可能需重新下载工具与介质。

参数细节见命令参考与bkeadm 配置参数。

卸载成功示意（如何判断干净） ​

前台（Web） ​

• “集群生命周期管理”列表中对应集群已被移除。
• 管理集群：管理集群管理面（:31616）无法再登录或访问；引导节点管理面（:30010）列表中已无该管理集群。

后台（命令行） ​

• 业务集群：创建侧集群上kubectl get bc -A已无对应BKECluster。
• 管理集群：原管理集群API/管理面已不可用；在引导节点上kubectl get bc -A已无该管理集群。
• 引导集群：bke reset --all --mount正常结束，本地k3s/Kubernetes相关进程与容器已清理；（可选清理后）/bke与bke命令不存在。

文档导航 ​

表5 集群卸载文档导航