release-0.25.4

Added

• Operator configuration 'reconcile' section is now fully supported at CHI level under both 'reconcile' and old 'reconciling' name. Previously, only selected settings were available at CHI level.
• Allow to exclude namespaces that operator watches. by @AdheipSingh in #1770

spec:
  watch:
    namespaces:
      include: []
      exclude: [] # new

• Option to choose which probe should operator wait for during reconcile. Previously, it always waited for pod to be ready. This can now be configured in 'reconcile' section of operator or CHI:

spec:
  reconcile:
    host:
      wait:
        probes:
          startup: "yes"
          readiness: "no"

• ZooKeeper compression support by @wilkermichael in #1809
• Support watching multiple namespaces in OLM by @saeedhosseini21 in #1825. Closes #1491

Changed

• system.custom_metrics table is currently scrapped for monitoring in addition to metrics and asynchronous_metrics. That allows to inject custom monitoring data from ClickHouse side.
• Deprecated Endpoints API has been replaced with EndpointSlice. Closes 1801

Fixed

• Fixed a bug with long environment variables used for secrets being truncated. Closes #1804
• Fixed a bug that operator did not respect watched namespaces for CHK

Helm updates

• Define values.schema.json by @Slach in #1815. Closes #1814
• Added clickhouse-operator deployment strategy parameters to Helm chart by @Slach in #1789
• Publish operator helm chart to helm.altinity.com in addition to artifacthub.io

Full Changelog: release-0.25.3...release-0.25.4

release-0.25.3

Added

• Added support for pdbMaxUnavailable in CHK
• Added .spec.configuration.clusters[].pdbManaged for CHI and CHK that allow to set external PDBs by @zrudzionis in #1768

Fixed

• Add ZK error handling and logging by @wilkermichael in #1762
• Fixed collision between PDBs for CHI and CHK with the same name. As a side effect PDB for CHI will be re-created with this upgrade
• Fixed rare panic in buildCRFromObj() when it can not find CR
• Fixed update of storage configmap that might block in rare cases. Closes #1781
• Fixed the check for host to be included in remote_servers, that did not work correctly in some network configurations. Closes #1782

Helm updates

• feat(helm): add priority class to helm chart by @nobletooth in #1774
• feat(helm): publish as an OCI helm package as well by @ogirardot in #1779
• There is no 'helm repo upgrade', should be 'update' by @CaptTofu in #1780
• Hotfix port names, to avoid warning during helm install by @Slach in #1784

New Contributors

• @wilkermichael made their first contribution in #1762
• @zrudzionis made their first contribution in #1768
• @nobletooth made their first contribution in #1774
• @ogirardot made their first contribution in #1779
• @CaptTofu made their first contribution in #1780

Full Changelog: release-0.25.2...release-0.25.3

release-0.25.2

Fixed

• Refactored concurrent reconcile code to fix #1749
• Changed ClickHouse version detection code to reduce number of calls
• Force-skipped replica wait code for the first host in the cluster
• Fixed clickhouse-keeper manifests for old Kubernetes versions by @Slach in #1767

Full Changelog: release-0.25.1...release-0.25.2

release-0.25.1

Added

• Added an option to substitute macros in settings, can be enabled in spec.reconciling CHI section.

Fixed

• Fix panic by @alex-zaitsev in #1750. Closes #1749
• Fixed rootCA parsing. Closes #1666
• Added ownerReference in chi-storage config map. Closes #1714
• Fixed a bug when CHI was not included in the monitoring on operator restart until the end of reconcile
• Fixed a bug with podTemplate env variables being incorrectly merged from CHI template

Helm/misc changes

• reproduce dashboard installation for grafana helm chart by @Slach in #1725
• Edited template for ServiceMonitor by @virtualb0x in #1728
• add example for schema bootstrap via startup_scripts, fix https://git… by @Slach in #1732
• feat: users with SSL Auth by @viktordebulat in #1739
• fix service monitor template by @Slach in #1747
• Update grafana and prometheus, update grafana dashboards by @Slach in #1752

New Contributors

• @virtualb0x made their first contribution in #1728
• @viktordebulat made their first contribution in #1739

Full Changelog: release-0.25.0...release-0.25.1

release-0.25.0

Added

• Multiple service templates are now supported for a single purpose. Example of syntax:

  defaults:
    templates:
      serviceTemplates:
       - service-template
       - service-template-internal

• Added availabilityZone attribute for ZooKeeper spec:

  configuration:
    zookeeper: # Add Zookeeper
      nodes:
        - host: zookeeper
          port: 2181
          availabilityZone: "my-azone"

• Operator can now inject version specific ClickHouse configuration, it is configured in 'addons' section of operator configuration. This closes #1603 but can be used for other use cases as well
• Added an option to specify reconciling.runtime.reconcileShardsThreadsNumber and reconcilingShardsMaxConcurrencyPercent on the CHI level
• [Helm] ServiceMonitor additional configuration by @nlamirault in #1624
• [Helm] Add namespace override capability for multi-namespace deployments by @bwdmr in #1640
• [Helm] Add common labels and annotations to all resources by @dashashutosh80 in #1692
• [Helm] Add support for rbac at namespace scope in @dashashutosh80 #1698

Changed

• When a new cluster is started with reconcilingShardsMaxConcurrencyPercent=100, all shards are created in parallel. Previously, first shard was always created alone.
• The new option to wait for replication to catch up when adding a new replica is enabled by default. It can be configured in operator reconcile settings:

reconcile:
  host:
    wait:
      replicas:
        all: no
        new: yes
        delay: 10

Fixed

• Fixed a bug with underlying replicated tables were not properly created when adding new nodes sometimes. Closes #1689
• Fixed a bug when service was not updated if clusterIP is changed from missing to None in service template
• Fixed a bug when annotations were not removed from service if removed from service template

New Contributors

• @nlamirault made their first contribution in #1624
• @bwdmr made their first contribution in #1640
• @DougTidwell made their first contribution in #1660
• @dashashutosh80 made their first contribution in #1692

Full Changelog: release-0.24.5...release-0.25.0

release-0.24.5

What's Changed

• Follow-up to the previous release. CLICKHOUSE_SKIP_USER_SETUP is not added if default entrypoint is not used.
• Fixed a bug when ClickHouseOperatorConfiguration was not correctly merged sometimes
• Adjusted default configuration so configuration files with 'no_restart' in the file name would not cause ClickHouse restarts
• Changed how operator handles remote_servers.xml when doing rolling updates. Now instead of removing/adding a replica, it sets low priority to make sure replica does not get any traffic from distributed queries
• Bumped dependencies to address CVE-2025-22868 and CVE-2025-22870
• Fixed a typo in Keeper Prometheus alert by @morkalfon in #1657
• Fixed Keeper dashboard - Ephemeral Node count by @Slach in #1656

New Contributors

• @morkalfon made their first contribution in #1657

Full Changelog: release-0.24.4...release-0.24.5

release-0.24.4

What's Changed

• Worked around a bug in docker entrypoint.sh introduced by ClickHouse change ClickHouse/ClickHouse#75259. Closes #1631

NOTE: All CHI will be restarted with this upgrade since it requires to modify pod template.

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

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

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

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

• fix helm chart release 0.24.2 - #1584, thanks @janeklb

Full Changelog: release-0.24.1...release-0.24.2

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

• fix: fix slice init length by @cuishuang in #1523
• fix: don't b64 encode configmap data by @marvinWolff in #1540
• fix helm chart release publication in #1589

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

• @lorellalou made their first contribution in #1527
• @marvinWolff made their first contribution in #1540
• @janeklb made their first contribution in #1555
• @xavierleune made their first contribution in #1566
• @ondrej-smola made their first contribution in #1572

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