RELEASE_NOTES.md

Apache Pulsar Helm Chart Release Notes

3.0.0

This Apache Pulsar Helm Chart release contains several important new features, bug fixes, and some potential breaking changes. Most importantly, it ships with Apache Pulsar 2.10.2, by default.

Breaking Changes

• Switch from custom deployment of Prometheus and Grafana to using the kube-prometheus-stack. This change includes enabling PodMonitors by default for the Broker, Bookkeeper, Zookeeper, Autorecovery, and Proxy pods, as well as deploying the related CRDs by default. If this will be a problem, here is documentation to disable the CRD deployment. Additionally, the Grafana Dashboards that were previously deployed will no longer ship with this Helm Chart. Here is documentation on available alternatives. Here is the related PR apache#299.

Upgrade considerations

• When upgrading from any previous version of the helm chart, there are a few things to consider. First, this is the first release of the Helm Chart that packages a 2.10 docker image as the default version of Apache Pulsar. Notably, that docker image is run as a non root user, by default. As a result, you may have issues with Zookeeper and Bookkeeper file system permissions. If so, you may need to use the following in your initial values file. See https://github.com/apache/pulsar-helm-chart#upgrading-to-apache-pulsar-2100-and-above-or-helm-chart-version-300-and-above for more instructions.

    securityContext:
      fsGroup: 0
      fsGroupChangePolicy: "Always"

• When upgrading to the kube-prometheus-stack, the helm chart will not install the CRDs by default. You can install those following these instructions: https://github.com/prometheus-community/helm-charts/tree/main/charts/kube-prometheus-stack#from-40x-to-41x.

What's Changed

• Bump Apache Pulsar 2.10.2 by @Jason918 in apache#310
• Replace monitoring solution with kube-prometheus-stack dependency by @michaeljmarshall in apache#299

Enhancements

• Add nodeSelector to cluster initialize pod by @ThelonKarrde in apache#284
• Alphabetically sort list of super users by @arnarg in apache#291
• Use appVersion as default tag for Pulsar images by @lhotari in apache#200
• Support mechanism to provide external zookeeper-server list to build global/configuration zookeeper by @rdhabalia in apache#269
• Update how to configure external zookeeper servers by @michaeljmarshall in apache#308
• Allow to use selectors with volumeClaimTemplates by @claudio-vellage in apache#286
• Allow specifying the nodeSelector for the init jobs by @elangelo in apache#225
• Added pdb version detection by @yuweisung in apache#260
• Allow bk cluster init pod to restart on failure by @michaeljmarshall in apache#303

Bug Fixes

• Remove '|| yes' in bk cluster init script by @michaeljmarshall in apache#305
• Fix bookkeeper metadata init when specifying metadataPrefix by @michaeljmarshall in apache#316
• feat(certs): use actual v1 spec for certs by @smazurov in apache#233

Build and CI Changes

• Only send notifications to commits@ ML by @michaeljmarshall in apache#302
• Remove GitHub Action Workflows that release the chart by @michaeljmarshall in apache#300
• Use cert-manager to generate certs for tests by @michaeljmarshall in apache#306
• Upgrade to Cert Manager 1.7.3 by @michaeljmarshall in apache#307
• Fix monitoring configuration broken by #299 by @michaeljmarshall in apache#313
• Replace handmade lint script with official action by @tisonkun in apache#292
• [test] Add a consumer to the helm tests by @michaeljmarshall in apache#312
• Fix CI by modifying Chart.yaml and updating ct lint command by @michaeljmarshall in apache#315
• Do not require version bump by @michaeljmarshall in apache#314

Release Update

The Apache Pulsar Helm Chart's release process has changed from an automated process to a manual one, in order to align with the Apache Software Foundation's requirements for voting on releases. As a result, you can expect releases to be hosted at https://downloads.apache.org/pulsar/helm-chart/. Please see the RELEASE.md for the new release process.

New Contributors

Thank you to all of our new contributors!

• @ThelonKarrde made their first contribution in apache#284
• @arnarg made their first contribution in apache#291
• @smazurov made their first contribution in apache#233
• @rdhabalia made their first contribution in apache#269
• @yuweisung made their first contribution in apache#260
• @tisonkun made their first contribution in apache#292
• @Jason918 made their first contribution in apache#310
• @elangelo made their first contribution in apache#225
• @claudio-vellage made their first contribution in apache#286

Full Changelog: https://github.com/apache/pulsar-helm-chart/compare/pulsar-2.9.4...pulsar-3.0.0