v5.16.0

This release adds a bunch of cool features, so be sure to check it out!

Highlights include:

• Grafana 11.3.0 as the new default version
• Support for Notification Templates
• Custom HTTP Headers, which allow for more authentication models and rudimentary multi-org support
• Fetch TLS secrets from different namespaces

Upgrade instructions

Using Helm

# Upgrade the operator image & deployment
helm upgrade -i grafana-operator oci://ghcr.io/grafana/helm-charts/grafana-operator --version v5.16.0
# Upgrading CRDs
kubectl apply --server-side --force-conflicts -f https://github.com/grafana/grafana-operator/releases/download/v5.16.0/crds.yaml

Using kubectl

# Namespace Scope
kubectl replace -f https://github.com/grafana/grafana-operator/releases/download/v5.16.0/kustomize-namespace_scoped.yaml
# Cluster Scope
kubectl replace -f https://github.com/grafana/grafana-operator/releases/download/v5.16.0/kustomize-cluster_scoped.yaml 

Using kustomize

flux pull artifact oci://ghcr.io/grafana/kustomize/grafana-operator:v5.16.0 --output ./grafana-operator/

Using OLM

Releases are published to operatorhub.io as well as the OpenShift Operator Catalog. Depending on the installation, existing installations will either upgrade automatically or require approval from an administrator.

Changelog:

Features

• added support for custom HTTP headers by @xorilog in #1756
• set rule version record limit by default by @weisdd in #1763
• bump grafana to 11.3.0 by @weisdd in #1763
• allow for images in spec.version by @theSuess in #1764
• added support for TLS to support custom secret namespaces by @amimof in #1797
• added 'webex' as valid type for GrafanaContactPoints (#1798) by @FabianWilms in #1799
• add support for notification templates by @chenlujjj in #1775

Fixes

• yaml indentation for ServiceMonitor by @nlamirault in #1757
• remove rules requirement for ingress by @theSuess in #1791
• Use Patch instead of Update to add/remove finalizers by @Baarsgaard in #1801
• GrafanaNotificationPolicy reconcile loop ignoring namespace boundaries by @Baarsgaard in #1815

Dependencies

• chore(deps): bump softprops/action-gh-release from 1 to 2 by @dependabot in #1753
• chore(deps): bump tj-actions/changed-files from 45.0.3 to 45.0.4 in the gha group by @dependabot in #1752
• chore(golang): bump version to 1.23.3 by @weisdd in #1759
• chore(deps): bump the gomod group with 7 updates by @dependabot in #1772
• chore(deps): bump the gha group with 2 updates by @dependabot in #1784
• chore(deps): bump the gomod group across 1 directory with 2 updates by @dependabot in #1785
• chore(deps): bump the gomod group with 5 updates by @dependabot in #1792
• chore(deps): bump github.com/onsi/ginkgo/v2 from 2.22.0 to 2.22.1 in the gomod group by @dependabot in #1802
• chore(deps): bump github.com/onsi/gomega from 1.36.1 to 1.36.2 in the gomod group by @dependabot in #1806
• chore(deps): bump tj-actions/changed-files from 45.0.5 to 45.0.6 in the gha group by @dependabot in #1813
• chore(deps): bump github.com/onsi/ginkgo/v2 from 2.22.1 to 2.22.2 in the gomod group by @dependabot in #1812
• chore(deps): bump sigs.k8s.io/controller-runtime from 0.19.3 to 0.19.4 in the gomod group by @dependabot in #1819

New Contributors

• @xorilog made their first contribution in #1756
• @diurnalist made their first contribution in #1611
• @FabianWilms made their first contribution in #1799

Full Changelog: v5.15.1...v5.16.0

v5.15.1

This release only affects the way we publish helm charts. See the release notes for v5.15.0 for a more comprehensive list.

v5.15.0

What's Changed

Changes

• Adds .svc to internal grafana adminUrl by @amimof in #1713
• Implement spec.uid for GrafanaFolder by @Baarsgaard in #1686
• feat: add Name field to GrafanaAlertRuleGroupSpec by @chenlujjj in #1727
• Implement spec.uid for GrafanaDashboard by @Baarsgaard in #1694
• feat: CEL validation of valuesFrom object ensuring refs are defined by @Baarsgaard in #1729
• Enable forced deletion of GrafanaFolder by @Baarsgaard in #1728
• fix: always use related image if it is a hash by @pb82 in #1733
• refactor: move tls block to spec.client by @theSuess in #1690
• feat: add disableProvenance option to GrafanaAlertRuleGroupSpec by @chenlujjj in #1715
• Add editable field to GrafanaNotificationPolicySpec by @chenlujjj in #1739
• fix: remove logging of override values by @theSuess in #1743
• feat: release helm charts to grafana/helm-charts by @theSuess in #1734

Docs

• docs: refresh home page by @theSuess in #1722
• docs: improve alerting documentation by @theSuess in #1724
• docs: update version in docs by @theSuess in #1705
• docs: add docs on how to change the log encoder using kustomize by @theSuess in #1706
• Move database field in example to jsonData by @michael-os in #1725

Dependencies

• chore(deps): bump github.com/prometheus/client_golang from 1.20.4 to 1.20.5 in the gomod group by @dependabot in #1721
• chore(deps): bump the gomod group with 5 updates by @dependabot in #1731
• chore(deps): bump github.com/onsi/gomega from 1.34.2 to 1.35.1 in the gomod group by @dependabot in #1740

New Contributors

• @amimof made their first contribution in #1713
• @chenlujjj made their first contribution in #1727
• @michael-os made their first contribution in #1725

Full Changelog: v5.14.0...v5.15.0

v5.14.0

What's Changed

Heads up! This release contains a refactoring of the RBAC rules in our deployment templates. If you encounter any permission issues please let us know!

Changes

• Move category annotation to the correct struct in GrafanaDashboard and Grafanas by @Baarsgaard in #1672
• docs: add resync period warning by @theSuess in #1689
• Fix example prometheus datasource by @Tualua in #1698
• feat: contact point overrides by @theSuess in #1670
• feat: add user agent to requests made by operator by @theSuess in #1700
• Add logging options to Helm chart by @Baarsgaard in #1691

Dependencies

• chore(deps): bump the gha group with 2 updates by @dependabot in #1687
• chore(deps): bump the gomod group across 1 directory with 7 updates by @dependabot in #1688
• chore(deps): bump k8s.io/apiextensions-apiserver from 0.31.0 to 0.31.1 in the gomod group by @dependabot in #1702
• chore(deps): bump the gha group with 5 updates by @dependabot in #1701

New Contributors

• @Tualua made their first contribution in #1698

Full Changelog: v5.13.0...v5.14.0

v5.13.0

What's Changed

Changes

• feat(helm): add option to disable rbac creation by @Idotno-1 in #1641
• feat(security): implement tls block for grafana external by @aboulay-numspot in #1628
• fix(helm): allow setting pod labels by @pharaujo in #1649
• feat: basic auth support for dashboards from url by @pb82 in #1617
• fix: sort plugin lists by @theSuess in #1656
• Annotate CRD structs with categories by @Baarsgaard in #1650
• fix: correctly set disableResolveMessage for contact points by @theSuess in #1669
• fix: add common labels to created resources by @theSuess in #1661

Development

• Local yq is not downloaded or referenced properly in Makefile by @Baarsgaard in #1637
• update pinned release documentation by @peterbecich in #1665
• documentation comment about kubectl apply error by @peterbecich in #1668
• docs: Add subfolder for GrafanaDashboard and GrafanaFolder in documentation by @aboulay-numspot in #1629

Dependencies

• chore(deps): bump sigstore/cosign-installer from 3.5.0 to 3.6.0 in the gha group by @dependabot in #1635
• chore(deps): bump tj-actions/changed-files from 44.5.7 to 45.0.0 by @dependabot in #1648
• chore(deps): bump tj-actions/changed-files from 45.0.0 to 45.0.1 in the gha group by @dependabot in #1655
• chore(deps): bump kyverno/action-install-chainsaw from 0.2.8 to 0.2.9 in the gha group by @dependabot in #1667

New Contributors

• @Idotno-1 made their first contribution in #1641
• @Baarsgaard made their first contribution in #1637
• @pharaujo made their first contribution in #1649
• @peterbecich made their first contribution in #1668

Full Changelog: v5.12.0...v5.13.0

v5.12.0

What's Changed

Changes

• feat: add support for notification policies by @theSuess in #1610
• feat: enable pprof endpoint by @theSuess in #1632
• chore: bump version 5.12 by @theSuess in #1634

Dependencies

• chore(deps): bump the gha group with 3 updates by @dependabot in #1631
• chore(deps): bump github.com/onsi/gomega from 1.34.0 to 1.34.1 in the gomod group by @dependabot in #1630

Full Changelog: v5.11.0...v5.12.0

v5.11.0

What's Changed

Changes

• docs: add proposal for grafana dashboard parent folder management by @aboulay-numspot in #1592
• HELM: Enable deploying additional objects with helm chart by @gitbluf in #1607
• feat: add parentFolderRef field in GrafanaFolder by @aboulay-numspot in #1604
• docs: Add proposal for ssl specification in Grafana external block by @aboulay-numspot in #1594
• feat: Add folderUID and folderRef in GrafanaDashboard CRD by @aboulay-numspot in #1601
• fix: remove required attribute from folder conditions by @theSuess in #1624
• fix: requeue on apply errors by @theSuess in #1625
• chore: bump version to 5.11.0 by @theSuess in #1627

Dependencies

• chore(deps): bump kyverno/action-install-chainsaw from 0.2.5 to 0.2.6 in the gha group by @dependabot in #1609
• chore(deps): bump the gomod group with 4 updates by @dependabot in #1615
• chore(deps): bump tj-actions/changed-files from 44.5.5 to 44.5.6 in the gha group by @dependabot in #1616
• chore(deps): bump kyverno/action-install-chainsaw from 0.2.6 to 0.2.7 in the gha group by @dependabot in #1619
• chore(deps): bump github.com/onsi/gomega from 1.33.1 to 1.34.0 in the gomod group by @dependabot in #1620

New Contributors

• @gitbluf made their first contribution in #1607

Full Changelog: v5.10.0...v5.11.0

v5.10.0

What's Changed

Changes

• feat(helm): All recommended Kubernetes labels by @nlamirault in #1538
• chore(codeowners): fix handle for HVBE by @weisdd in #1571
• fix: use controller reference instead of owner reference by @theSuess in #1574
• chore(CRDs): publish full CRDs by @weisdd in #1579
• docs: Fix parameter auth.disable_login_form type in README.md by @bodji in #1568
• fix: reason and log typos by @crflynn in #1586
• fix: use correct error propagation logic in alert rule group handler by @theSuess in #1584
• Update release.yaml to add linux/ppc64le by @whaifang in #1589
• fix: use frontend settings endpoint for version detection by @theSuess in #1583
• Feat: add parentFolderUID field in GrafanaFolder CRD by @aboulay-numspot in #1566
• fix: improve nested folder handling by @theSuess in #1600
• fix: use correct folder uid to update permissions by @timp87 in #1602
• chore: prep for release 5.10.0 by @theSuess in #1603

Dependencies

• chore(deps): bump kyverno/action-install-chainsaw from 0.2.3 to 0.2.4 in the gha group by @dependabot in #1575
• chore(deps): bump sigs.k8s.io/controller-runtime from 0.18.3 to 0.18.4 in the gomod group by @dependabot in #1576
• chore(deps): bump the gomod group with 4 updates by @dependabot in #1582
• chore(deps): bump the gha group across 1 directory with 3 updates by @dependabot in #1598

New Contributors

• @bodji made their first contribution in #1568
• @crflynn made their first contribution in #1586
• @whaifang made their first contribution in #1589

Full Changelog: v5.9.2...v5.10.0

v5.9.2

What's Changed

Changes

• chore(makefile): simplify api-docs generation by @weisdd in #1551
• fix crd release upload by @NissesSenap in #1552
• feat(workflows): e2e matrix, avoid version skew for kubectl by @weisdd in #1550
• Adding Grafana v10 ContactPoint types by @andrejshapal in #1549
• docs: add instructions for terraform installation by @theSuess in #1557
• ci: add merge-group trigger to enable merge queues by @theSuess in #1559
• chore: update default grafana version by @theSuess in #1558
• fix(flux): maintain a copy of CRDs and the ClusterRole in deploy/kustomize/base by @weisdd in #1562
• docs: Create proposal about parent folder management for GrafanaFolder CR by @aboulay-numspot in #1564
• chore: bump version to 5.9.2 in prep for new release by @theSuess in #1565

Dependencies

• chore(deps): bump the gha group with 3 updates by @dependabot in #1556
• chore(deps): bump the gomod group across 1 directory with 6 updates by @dependabot in #1555
• chore(deps): bump the gha group with 2 updates by @dependabot in #1563

New Contributors

• @andrejshapal made their first contribution in #1549
• @aboulay-numspot made their first contribution in #1564

Full Changelog: v5.9.1...v5.9.2

v5.9.1

NOTE: Users that rely on the kustomize artifact (oci:/ghcr.io/grafana/kustomize/grafana-operator:v5.9.1) are advised to skip this version as kustomization.yaml references files outside of the file tree, and, thus, cannot be built.

What's Changed

Changes

• chore(workflows): verify golangci-lint config by @weisdd in #1518
• Update Meeting Time by @theSuess in #1511
• chore: categorize dependency updates and other changes in auto-generated release notes by @pddg in #1515
• fix: use the external url for fetching version if set by @theSuess in #1527
• fix(GrafanaFolder): proper status updates for removed CRs, don't fail on missing folder in onFolderDeleted events by @weisdd in #1516
• fix(GrafanaDashboard): properly finish reconciliation in onDashboardDeleted when dashboard is missing by @weisdd in #1517
• feat(controllers): make instanceSelector immutable by @weisdd in #1525
• docs: clarify deployment type in issue template by @theSuess in #1534
• feat: add KeepLast as valid value for no data & exec err state by @theSuess in #1528
• fix: do not return error if no env is defined by @theSuess in #1537
• feat: add notification settings to alert rule group by @theSuess in #1536
• feat(controllers): add support for instanceMatchSelector by @Ronan-WeScale in #1497
• fix (kustomize): missing permissions for grafanacontactpoint in rbac.yaml for kustomize by @talron23 in #1539
• feat/fix(rbac): use generated RBAC in kustomize and helm, grant access to leases by @weisdd in #1540
• fix(datasource-controller): replace flaky e2e test for secureJsonData with a unit test by @weisdd in #1544
• chore(controller-shared): simplify labelsSatisfyMatchExpressions by @weisdd in #1542
• chore(makefile): simplify kustomize CRD updates by @weisdd in #1545
• prepare 5.9.1 by @NissesSenap in #1547

Dependencies

• chore(deps): bump golangci/golangci-lint-action from 4.0.0 to 5.0.0 by @dependabot in #1509
• chore(deps): bump the gha group with 2 updates by @dependabot in #1521
• chore(deps): bump tj-actions/changed-files from 44.3.0 to 44.4.0 in the gha group by @dependabot in #1531
• chore(deps): bump the gomod group across 1 directory with 7 updates by @dependabot in #1530
• chore(deps): bump golangci/golangci-lint-action from 5.3.0 to 6.0.1 by @dependabot in #1532

New Contributors

• @pddg made their first contribution in #1515
• @Ronan-WeScale made their first contribution in #1497
• @talron23 made their first contribution in #1539

Full Changelog: v5.9.0...v5.9.1