Altinity Kubernetes Operator for ClickHouse® Release Notes

The latest release of the Altinity Kubernetes Operator for ClickHouse® is always available at https://github.com/Altinity/clickhouse-operator/releases/latest. Links to release notes for older releases follow the notes for the current release.

Release 0.24.4

Released 2025-02-06

Full Changelog: release-0.24.3...release-0.24.4

Fixed

Release 0.24.3

Released 2025-01-27

Full Changelog: release-0.24.2...release-0.24.3

Added

  • Ability to suspend ClickHouseInstallation and ClickHouseKeeper reconciliation by @a7i in #1580. Controlled by .spec.suspend attribute. Closes #1433.
  • New clickhouse_operator_chi metric in metrics-exporter
  • Add kafka-related alerts by @Slach in #1596

Changed

  • NormalizedCHI that is used to plan reconciliation was moved from CHI status to a separate configmap object. Closes #1444.
  • Changed a way ClickHouse is restarted in order to pickup server configuration change. Instead of pod re-creation it tries SYSTEM SHUTDOWN first. That speeds things up on nodes with big volumes, since those should not be re-attached.
  • Unused fields ‘HostsUnchanged’ and ‘HostsDelete’ were removed from extended status output
  • Upgrade prometheus-operator to 0.79.0 (alerts tested with prometheus 3.0.1) by @Slach in #1599
  • Interserver secret is now used for ‘all-sharded’ cluster if it is defined for the main cluster

Fixed

  • Custom ZK path creation is not retried anymore for stopped CHI
  • Fixed CVE-2024-45338 in golang.org/x/net 0.23.0

New Contributors

  • @a7i made their first contribution in #1580

Release 0.24.2

Released 2024-12-06

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/release-0.24.1...release-0.24.2

Changed

  • Inherit kubectl annotations when managing statefulsets by @ondrej-smola in #1582. That allows to avoid unexpected restarts
  • Remove openSSL from /etc/clickhouse-keeper/config.d/01-keeper-01-default-config.xml by @Slach in #1574
  • Faster startup of big clusters

Fixed

Release 0.24.1

Released 2024-12-06

Full Changelog: release-0.24.0...release-0.24.1

Added

  • Option to exclude certain labels/annotations from exposed prometheus metrics. Closes #1525

Changed

  • Removed SYSTEM DROP DNS cache that is not needed since ClickHouse 19.11
  • Removed redundant synchronization between threads when multiple shards were reconciled in parallel. That speeds up reconcile of big clusters
  • Action log in CHI/CHK status is disabled by default
  • When custom (Zoo)Keeper path is used, operator will re-try path creation until (Zoo)Keeper is available
  • Improved Keeper scale out/in logic
  • Respect PVC storage value if current value is greater than value in spec by @ondrej-smola in #1573
  • Update zookeeper deployment examples to 3.8.4 by @Slach in #1553

Fixed

Helm and docs

  • Doc : Add OpenEBS example by @lorellalou in #1527
  • Hotfix volumeClaimTemplate linking in chk-examples by @Slach in #1543
  • fix helm chart’s README by @janeklb in #1555
  • Hotfix chk crd, add {chk} and {chkID} to .spec.templates.serviceTemplates.generatedName description by @Slach in #1562
  • fix: add missing CRD link to helm chart readme by @janeklb in #1563
  • Docs: fix version to match manifests in chi-examples/08-* by @xavierleune in #1566
  • Add chk image pull secrets example by @Slach in #1576

New contributors

Release 0.24.0

Released 2024-10-14

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/release-0.23.7...release-0.24.0

Backward Incompatible Changes

  • ClickHouseKeeper support has been fully re-written. It is now fully compatible with CHI in syntax and supported functionality that closes multiple issues discovered by early adopters. The downside is that CHK resources created by operator 0.23.x will loose the storage and change service name due to different naming conventions. See CHK upgrade instructions from 0.23 to 0.24 for the details. This closes #1504, #1497, #1469, #1465, #1459, #1408, #1362, #1296

Added

Changed

Fixed

New Contributors

Older releases

Details of all releases, including older releases, are available through the project’s Releases page.