-
Notifications
You must be signed in to change notification settings - Fork 889
Description
Problem
The Grafana Helm chart we currently use (grafana/grafana from https://grafana.github.io/helm-charts) has been deprecated. Running make minikube-setup-grafana now produces:
WARNING: This chart is deprecated
The chart was migrated to grafana-community/helm-charts effective January 30, 2026. Updates and support are now only provided in the new repository.
What needs to change
1. build/Makefile
Update the setup-grafana target (line ~914) to use the new repo and chart:
- Old repo:
helm repo add grafana https://grafana.github.io/helm-charts - New repo:
helm repo add grafana-community https://grafana-community.github.io/helm-charts - Old chart:
helm upgrade grafana grafana/grafana ... - New chart:
helm upgrade grafana grafana-community/grafana ...
The uninstall-grafana target should not need changes since it references the release name, not the chart.
2. build/grafana.yaml and build/grafana-frontend.yaml
Review these values files for compatibility with the new chart. Known breaking changes across major versions:
- v7.0.0:
global.image.registryrenamed toglobal.imageRegistry - v10.0.0: Static alerting resources now support Helm templating — template expressions like
{{ $labels.instance }}must be escaped - v11.0.0: Minimum Kubernetes version increased to 1.25; deprecated API references removed
Our current values (service port, tolerations, affinity, sidecar dashboards, plugins, datasources) should be compatible, but this should be verified by installing the new chart and confirming dashboards load correctly.
3. Documentation: site/content/en/docs/Guides/metrics.md
The Grafana Installation section references the old chart and repo. Update:
- The repo link text from "Grafana Community Kubernetes Helm Charts" URL
https://grafana.github.io/helm-charts/tohttps://grafana-community.github.io/helm-charts - The
helm repo addandhelm upgradecommands to usegrafana-communityinstead ofgrafana - The Google Cloud Managed Prometheus section also references the Grafana installation, but since it says "Install Grafana as above", it should not need separate changes
Guidance for contributors
This is a good first issue if you're new to the project. Here's how to test:
- Follow the Agones development guide to set up a local environment
- Make the changes to the Makefile and docs
- Run
make minikube-setup-prometheusthenmake minikube-setup-grafana(or the equivalent for your dev cluster) - Verify the deprecation warning is gone
- Port-forward Grafana (
kubectl port-forward deployments/grafana 3000 -n metrics) and confirm dashboards load with data - Run
make site-serverto verify the docs render correctly