MicroK8s中helm uninstall未删除全部资源问题求助

问题原因 #

1. 资源带有helm.sh/resource-policy: keep注解 #

Bitnami官方的WordPress Chart（包含MariaDB依赖）默认会给StatefulSet、PVC等核心资源添加该注解，目的是防止卸载时误删持久化数据。Helm识别到这个注解后，会跳过删除这些资源，导致它们管理的Pod、ReplicaSet也随之残留。

2. Helm钩子资源未配置自动清理 #

Chart中的部分初始化钩子（比如数据库初始化Job）如果未设置hook-delete-policy: hook-succeeded,hook-failed，卸载时Helm不会自动清理这些钩子资源，可能引发关联Pod/ReplicaSet残留。

3. Kubernetes资源Finalizer残留 #

如果StatefulSet、Pod等资源的Finalizer字段未被正常处理，Kubernetes会阻止资源被彻底删除，进而导致Pod、ReplicaSet卡在集群中。

解决办法 #

步骤1：排查残留资源详情 #

先确认残留资源的关联控制器、注解及Finalizer信息：

# 列出mydemo命名空间下所有资源
kubectl get all -n mydemo

# 查看目标Pod的注解和Finalizer
kubectl describe pod happy-panda-mariadb-0 -n mydemo | grep -E "Annotations|Finalizers"

# 查看ReplicaSet所属的控制器（Deployment/StatefulSet）
kubectl describe rs <replica-set-name> -n mydemo | grep "Controlled By"

步骤2：针对性清理资源 #

情况A：带有keep注解的资源

若无需保留数据，直接删除关联控制器即可连带清理Pod和ReplicaSet：

# 删除MariaDB StatefulSet
kubectl delete statefulset happy-panda-mariadb -n mydemo

# 删除WordPress Deployment
kubectl delete deployment happy-panda-wordpress -n mydemo

# （可选）删除关联PVC（彻底清理数据）
kubectl delete pvc -l app.kubernetes.io/instance=happy-panda -n mydemo

情况B：钩子资源残留

清理未自动删除的钩子Job及Pod：

# 筛选出所有Helm钩子资源
kubectl get jobs,pods -n mydemo -l helm.sh/hook!=null

# 删除指定钩子Job和Pod
kubectl delete job <hook-job-name> -n mydemo
kubectl delete pod <hook-pod-name> -n mydemo

情况C：Finalizer残留

移除资源的Finalizer后再删除：

# 编辑Pod，清空Finalizers字段内容
kubectl edit pod happy-panda-mariadb-0 -n mydemo
# 找到Finalizers字段，删除其中所有值后保存退出
kubectl delete pod happy-panda-mariadb-0 -n mydemo

步骤3：提前配置避免残留 #

下次安装Bitnami WordPress时，通过参数禁用keep注解，让Helm卸载时自动清理所有资源：

helm install happy-panda bitnami/wordpress -n mydemo \
  --set mariadb.persistence.resourcePolicy=delete \
  --set persistence.resourcePolicy=delete

内容的提问来源于stack exchange，提问作者hey