Kubernetes集群中Rancher手动卸载(system-tools崩溃报错场景)
Rancher 手动完整卸载操作步骤
第一步:清理Rancher Helm部署残留
- 执行命令移除Rancher对应的Helm Release:
helm uninstall rancher -n rancher - 如果命令返回
release: not found,说明对应的Helm元数据已被之前的工具清理,直接跳过该步骤。 - 强制删除rancher命名空间,清除所有残留工作负载:
kubectl delete namespace rancher --force --grace-period=0
第二步:清理Rancher依赖的Cert-Manager残留
- 执行命令移除Cert-Manager对应的Helm Release:
helm uninstall cert-manager -n cert-manager - 强制删除cert-manager命名空间:
kubectl delete namespace cert-manager --force --grace-period=0 - 删除部署Rancher时手动安装的Cert-Manager CRD:
kubectl delete crd certificates.cert-manager.io issuers.cert-manager.io clusterissuers.cert-manager.io certificaterequests.cert-manager.io
第三步:清理Rancher专属集群级CRD
- 批量匹配并删除所有Rancher、Cattle域的自定义资源定义:
kubectl delete crd $(kubectl get crd | grep -E 'cattle.io|rancher.io' | awk '{print $1}')
若执行过程中弹出"服务器未找到请求资源"类警告,属于正常情况:此前的清理流程已删除部分CRD实例,匹配到的已不存在条目会被自动跳过,不影响清理效果。
第四步:清理残留集群权限与资源元数据
- 删除所有Rancher专属的集群级权限绑定、角色资源:
kubectl delete clusterrolebinding $(kubectl get clusterrolebinding | grep -E 'cattle-|rancher-' | awk '{print $1}')kubectl delete clusterrole $(kubectl get clusterrole | grep -E 'cattle-|rancher-' | awk '{print $1}') - 遍历所有命名空间,移除Rancher写入的注解、标签配置:
kubectl get namespaces -o json | jq '.items[] | del(.metadata.annotations["cattle.io/*"], .metadata.labels["cattle.io/*"]) | .metadata.name' | xargs -I {} kubectl patch namespace {} --type=json -p '[{"op":"remove","path":"/metadata/annotations"},{"op":"remove","path":"/metadata/labels"}]'
若执行patch操作报字段不存在的错误,说明对应命名空间已无Rancher残留配置,直接跳过即可。
- 对卡在终止状态的命名空间,强制移除残留finalizer:
kubectl get namespaces --field-selector status.phase=Terminating -o json | jq '.items[] | del(.spec.finalizers) | .metadata.name' | xargs -I {} kubectl replace namespace {} --subresource=finalizer -f -
第五步:卸载结果校验
- 执行以下命令逐项确认无Rancher残留资源:
- CRD残留校验:
kubectl get crd | grep -E 'cattle|rancher',无返回结果即为清理完成 - 命名空间残留校验:
kubectl get ns | grep -E 'cattle|rancher|cert-manager',无返回结果即为清理完成 - 集群权限残留校验:
kubectl get clusterrolebinding | grep -E 'cattle|rancher',无返回结果即为清理完成
- CRD残留校验:
内容的提问来源于stack exchange,提问作者Kokizzu
相关产品推荐
相关产品推荐

