使用Helm Charts实现Grafana持久化模式部署的问题咨询

前置故障排查 #

• 官方Grafana Chart默认使用Deployment+PVC即可实现持久化，无需自行修改为StatefulSet，自行改造StatefulSet时若卷声明模板配置与存储端不匹配，也会导致Pod启动失败，建议优先使用官方原生配置方案
• 优先排查Pod启动报错：执行kubectl logs <grafana-pod-name> -n <namespace>，重点关注权限类报错：Grafana容器默认运行用户ID为472，挂载的PV目录如果没有给UID 472开放读写权限，会直接导致启动失败，这是90%以上同类问题的根因
• 检查PVC绑定状态：执行kubectl get pvc -n <namespace>，确认PVC状态为Bound，如果处于Pending状态需要检查StorageClass是否正常运行、PV的容量/访问模式是否和PVC要求匹配
• 如果使用hostPath、本地PV这类节点本地存储方案，需要提前在对应节点的挂载路径执行chown 472:472 /path/to/volume修改目录属主

官方Chart持久化正确配置 #

方案1：StorageClass自动供给PV（无需提前创建PV/PVC） #

编写自定义配置文件custom-values.yaml，加入以下配置：

persistence:
  enabled: true
  type: pvc
  accessModes:
    - ReadWriteOnce
  size: 10Gi
  # 如需指定特定StorageClass可取消注释填写对应名称，不填则使用集群默认StorageClass
  # storageClassName: "your-storageclass-name"
# 自动修正挂载目录权限，无需手动修改PV目录属主
initChownData:
  enabled: true

方案2：使用提前创建的PVC #

提前创建的PVC需要和Grafana部署在同一命名空间，修改custom-values.yaml配置如下：

persistence:
  enabled: true
  type: pvc
  existingClaim: "你提前创建的PVC名称"
initChownData:
  enabled: true

部署与验证操作 #

• 安装/更新Grafana Chart执行命令：helm upgrade --install grafana grafana/grafana -n <部署命名空间> -f custom-values.yaml
• 部署完成后检查PVC状态：kubectl get pvc -n <部署命名空间> | grep grafana，确认状态为Bound
• 检查Pod运行状态：kubectl get pods -n <部署命名空间> | grep grafana，确认状态为Running
• 验证持久化生效：登录Grafana创建测试仪表板，手动删除Pod等待重建后，确认测试仪表板依然存在

特殊场景兼容 #

• 如果集群禁用了容器root权限，initChownData初始化容器无法正常执行，需要提前在PV的存储端修改挂载目录属主为472:472，同时关闭权限初始化配置：

  initChownData:
    enabled: false
  

• 如果需要多Grafana实例共享持久化存储，需要将accessModes修改为ReadWriteMany，同时使用支持RWX模式的StorageClass

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