Minikube使用MySQL Operator报PVC未绑定等错误如何解决

你看到的三条报错中，0/1 nodes are available: 1 pod has unbound immediate PersistentVolumeClaims 是核心阻塞问题，其余两条均为该问题引发的次生报错：

• Patching failed with inconsistencies: (('remove', ('status', 'kopf'), ...)) 是MySQL Operator依赖的Kopf调谐框架，在调谐流程因存储问题反复中断时产生的框架层冗余报错，核心问题解决后会自动消除，无需单独处理
• Back-off restarting failed container 是Pod因存储卷无法挂载、主进程启动失败，被kubelet反复重启的表现，同样不是根因

1. 定位PVC绑定失败的具体原因 #

首先查看部署命名空间下的PVC状态：

kubectl get pvc -n <你部署InnoDBCluster的命名空间>

正常会看到3个MySQL实例对应的PVC处于Pending状态，执行以下命令查看PVC事件，确认失败原因：

kubectl describe pvc <Pending状态的PVC名称> -n <对应命名空间>

常见失败原因及修复方案如下：

• 集群无可用默认StorageClass，或PVC指定的StorageClass不存在
  先执行kubectl get sc查看集群现有可用的StorageClass列表，如果没有可用SC，先部署对应存储供给组件（本地测试环境可部署local-path-provisioner，生产环境使用对应云厂商块存储/分布式块存储供给组件）；如果有可用SC，在InnoDBCluster配置中显式指定存储配置，示例如下：

  apiVersion: mysql.oracle.com/v2
  kind: InnoDBCluster
  metadata:
    name: mycluster
  spec:
    secretName: mypwds
    tlsUseSelfSigned: true
    instances: 3
    router:
      instances: 1
    # 显式声明存储配置
    volumeClaimTemplate:
      spec:
        storageClassName: <集群中实际存在的SC名称>
        accessModes:
          - ReadWriteOnce
        resources:
          requests:
            storage: 10Gi
  

• StorageClass对应的存储后端资源不足/权限配置错误
  查看对应存储供给组件的运行日志，扩容存储池、修正存储后端的访问权限配置即可。
• 本地测试环境（minikube/kind/k3s等）未开启默认存储插件
  minikube环境执行以下命令开启存储插件：

  minikube addons enable default-storageclass
  minikube addons enable storage-provisioner
  

  kind环境需要手动部署local-path-provisioner组件；k3s环境默认自带local-path存储，若失效重启k3s服务即可恢复。

2. 检查前置依赖配置 #

你当前的InnoDBCluster配置中指定了secretName: mypwds，需要确认该Secret已在目标命名空间提前创建，Secret缺失也会导致Operator调谐流程异常，间接引发存储配置下发失败。创建Secret的参考命令：

kubectl create secret generic mypwds \
  --from-literal=rootUser=root \
  --from-literal=rootHost=% \
  --from-literal=rootPassword="自定义的root账号密码"

3. 验证修复结果 #

待所有PVC状态变为Bound后，删除异常重启的集群相关Pod，等待Operator自动重建：

kubectl delete pod -l mysql.oracle.com/cluster=mycluster -n <对应命名空间>

执行以下命令持续观察Pod状态：

kubectl get pods -n <对应命名空间> -w

待3个MySQL实例Pod、1个Router实例Pod全部进入Running状态，即部署完成，之前的Kopf框架报错、Pod重启报错都会自动消失。

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