使用kustomize把Grafana存储替换为持久存储时遇卷未找到解决方法
根因分析
报错信息提示容器volumeMounts索引为1的条目引用了grafana-storage卷,但Pod的volumes列表中不存在对应卷定义,问题由两个叠加的配置错误触发:
- 卷删除/替换逻辑失效:Kustomize v4.0.5 对
volumes这类内置带合并策略的字段(合并匹配键为name),使用列表项级别的$patch: delete语法无法正确匹配原有内存卷(emptyDir类型)并执行删除,后续新增的PVC卷配置也因合并规则失效没有正确写入volumes列表。 - 重复写入挂载配置:kube-prometheus默认的Grafana Deployment已经为容器配置了
/var/lib/grafana路径下的grafana-storage卷挂载,在patch中重复写入该volumeMount条目时,因合并逻辑未正确基于mountPath做同键替换,最终列表中生成了两个重复挂载项,对应报错中的volumeMounts[0]和volumeMounts[1],但因为卷定义未成功写入,两个挂载项引用的卷均无法匹配到volumes中的有效定义,触发Kubernetes API校验错误。
修复方案
无需手动执行删除操作,也无需重复写入已存在的挂载配置,利用Strategic Merge Patch基于name字段的同键覆盖逻辑,直接替换原有卷的配置即可。
- 修正
grafana-patch.yaml内容,移除错误的$patch: delete段、冗余的metadata标签定义、重复写入的volumeMounts配置:
apiVersion: apps/v1 kind: Deployment metadata: name: grafana namespace: monitoring spec: template: spec: volumes: # 按名称匹配,直接替换原有同名emptyDir卷的全部配置 - name: grafana-storage persistentVolumeClaim: claimName: grafana-storage
- 本地验证生成的最终配置,执行命令:
kustomize build .
在输出的Grafana Deployment配置中确认两点:
spec.template.spec.volumes列表中存在name: grafana-storage的项,且仅包含persistentVolumeClaim配置,无emptyDir字段- 所有
volumeMounts中引用的卷名,均能在volumes列表中找到对应定义,无重复的同路径挂载项
额外校验项
- 确认引入的kube-prometheus资源中,Grafana Deployment默认的
grafana-storage卷为内存emptyDir类型,保证名称匹配逻辑生效。 - 确认
grafana-pvc.yaml的命名空间与Grafana Deployment所在的monitoring命名空间一致,当前配置符合要求。 - 确认
storageClassName对应的存储类可正常创建PV,避免PVC绑定失败导致的Pod启动异常。
内容的提问来源于stack exchange,提问作者metadata
相关产品推荐
相关产品推荐

