Skip to content

Latest commit

 

History

History
516 lines (410 loc) · 32 KB

release_notes.md

File metadata and controls

516 lines (410 loc) · 32 KB

Release 0.20.3

What's Changed

  • Use alpine base image instead of UBI
  • Fix error handling when table already exists in ZooKeeper for new ClickHouse versions

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/release-0.20.2...release-0.20.3

Release 0.20.2

What's Changed

  • Added 'hostsCompleted' to the CHI status and events
  • Changed some 'default' profile settings:
    • Enabled 'do_not_merge_across_partitions_select_final'
    • Set 'load_balancing' to 'nearest_hostname'
    • Set niceness ('os_thread_priority') to 2.
  • Improved stability of metric-exporter when some ClickHouse nodes are responding slowly
  • Changed sequence of LB service creation to avoid a situation when service exists with no available endpoints
  • Added 'secure' flag at cluster level for enabling distributed queries over TLS
  • Addressed CVEs in dependent packages

Note: datatype for 'secure' flag has been changed from boolean to String (accepting, 'true', 'yes', '1' etc.)

Release 0.20.1

What's Changed

  • Improvements to Grafana dashboards by @Slach
  • Generate operator helm chart by @slamdev in Altinity#1049
  • Added cluster to PodDesruptionBudget selector. Closes #996. Note: PDB requires Kubernetes version 1.21 or above.
  • Added status.hostsCompleted to track reconcile progress
  • Do not restart CHI with restart attribute when operator is restarted
  • Address https://nvd.nist.gov/vuln/detail/CVE-2022-27664. Closes #1039
  • Fixed RBAC permissions for secrets. Closes #1051

New Contributors

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/release-0.20.0...release-0.20.1

Release 0.20.0

What's Changed

  defaults:
    storageManagement:
      provisioner: Operator
  • Use secret for clickhouse_operator credentials as default
  • Improve zookeeper scaleout by @Slach in Altinity#984
  • add loadaverage + network + disk panel to clickhouse dashboard by @Slach in Altinity#1015
  • comment out chopusername check by @SuzyWangIBMer in Altinity#1009
  • Reduced a size of status field
  • Improved logging

Fixed

  • Fixed a bug with cluster definitions being reset when CHI has been updated via k8s API POST method.
  • Fixed a problem of metrics exporter not being able to scrape any managed cluster when one of clickhouse nodes is slow
  • Fix zookeeper advanced setup with empty dir by @luluz66 in Altinity#993
  • Delete duplicate return by @Abirdcfly in Altinity#987
  • Fixes #991 - fix watch namespace regex by @mcgrawia in Altinity#992
  • Address CVE-2022-32149 by @bkuschel in Altinity#1035

New Contributors

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/release-0.19.2...release-0.20.0

Release 0.19.3

What's Changed

  • Fixed a possible loose of cluster state when operator has been restarted in the middle of reconcile.
  • Backport of Altinity#1009
  • add loadaverage + network + disk panel to clickhouse dashboard by @Slach in Altinity#1015

NOTE: There is a change in ClickHouseInstallation custom resource type, so make sure you deploy full installation manifest when upgrading.

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/release-0.19.2...release-0.19.3

Release 0.19.2

What's Changed

  • Fixed a bug in 0.19.0 and 0.19.1 versions when operator could be rebuilding remote-servers.xml from scratch after restart. When it happened, distributed queries might behave unexpectedly.

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/release-0.19.1...release-0.19.2

Release 0.19.1

What's Changed

  • Fixed MVs in Atomic databases support for ClickHouse versions 22.6 and above. Closes Altinity#989
  • Fixed tables with '{uuid}' macro in Atomic databases for ClickHouse versions 22.6 and above.
  • Fixed watch namespaces regexp by Altinity#992. Closes Altinity#991
  • Added "clickhouse.altinity.com/ready: yes|no" annotations for replica services for the use by external load balancer.
  • Updated podDisruptionBudget API version

Full changelog: https://github.com/Altinity/clickhouse-operator/compare/release-0.19.0...release-0.19.1

Release 0.19.0

What's Changed

  • Now 'clickhouse-operator' user is restricted to an IP address of the pod where clickhouse-operator is running. It can not be used from anywhere else.
  • In addition to hostRegexp, 'default' user is restricted to IP addresses of pods of the CHI. This fixes connectivity issues between shards in GKE.
  • ClickHouse 'interserver_http_host' is set to the service name and matches 'remote_servers'. It can be changed to full names with 'replicasUseFQDN' setting if needed. This fixes connectivity issues between replicas in GKE.
  • Changed the way schema is propagated to new shards. It is currently controlled by two cluster level settings:
  schemaPolicy:
    replica: None | All (default)
    shard: None | All (default) | DistributedTablesOnly

Previously, when adding shards only distributed tables and dependent objects were created (DistributedTablesOnly).

  • Added support for adding custom CA for operator connection to ClickHouse by @SuzyWangIBMer in Altinity#930
  • Fixed support of '{uuid}' macro for Atomic databases. Closes Altinity#857
  • Fixed a bug when replica sometimes was not removed from ZooKeeper when scaling down the cluster
  • Set container-log on ubi instead of busybox by @SuzyWangIBMer in Altinity#940
  • upgrade vertamedia-clickhouse-grafana to 2.5.0 in dashboard and grafana 7.5.16 by @Slach in Altinity#951
  • Improve grafana dashboards by @Slach in Altinity#952
  • Improve grafana-operator + prometheus-operator by @Slach in Altinity#953

New Contributors

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/0.18.5...release-0.19.0

Release 0.18.5

What's Changed

  • Dependencies were updated to address CVE-2022-21698 and CVE-2021-38561
  • generate_chart.sh by @ganievs in Altinity#925

New Contributors

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/0.18.4...0.18.5

Release 0.18.4

What's Changed

New Contributors

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/0.18.3...0.18.4

Release 0.18.3

What's Changed

  • Fixed a bug that might result in broken CHI if operator has been restarted during the reconcile
  • Added 'AGE' to CHI status
  • Added ClickHouse Keeper examples

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/0.18.2...0.18.3

Release 0.18.2

What's Changed

  • Operator now correctly respects configuration settings to exclude annotations from managed objects. Fixes #859
  • Make CHI status messages more human friendly

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/0.18.1...0.18.2

Release 0.18.1

What's Changed

  • fix non pointer mistake in metrics-exporter by @adu-bricks in Altinity#870
  • Helper files for operatorhub.io integration

New Contributors

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/0.18.0...0.18.1

Release 0.18.0

New features

  • arm64 packages are published (closes Altinity#852)
  • 'access_management' can be specified when defining users in CHI.
  • k8s secrets can be referenced when defining user passwords. See 05-settings-01-overview.yaml.

Changed

  • When CRD is deleted, operator keeps all dependent objects now (statefulsets, volumes). That prevents from incidental delete of a cluster.
  • When operator restarts it does not run a reconcile cycle anymore if CHI has not been changed. That prevents unneeded pod restarts. (Closes Altinity#855)
  • Operator configuration file format has been changed. See https://github.com/Altinity/clickhouse-operator/blob/0.18.0/config/config.yaml. Configuration in old format is supported for backwards compatibility.

Fixed

  • Fixed a bug 'unable to decode watch event: no kind "ClickHouseOperatorConfiguration" is registered' that could appear in some k8s configurations.
  • Removed INFORMATION_SCHEMA from schema propagation. (closes Altinity#854)
  • Added a containerPort to metrics-exporter (Altinity#834)

New Contributors

  • @johnhummelAltinity made their first contribution in Altinity#838
  • @jiangxinqi1995 made their first contribution in Altinity#846
  • @johnny made their first contribution in Altinity#834

Full Changelog: https://github.com/Altinity/clickhouse-operator/compare/0.17.0...0.18.0

Release 0.17.0

New features:

  • Labels and annotations from auto templates are now supported
  • Macros can be used in service annotations the same way as in generateName. Fixes Altinity#795

Changed:

  • Status object has been cleaned up

Fixed:

  • Database engine is now respected during schema migration
  • Fixed schema migration for ClickHouse 21.11+
  • Removed extra waits for single-node CHI changes
  • Fixed a possible race conditions with labeling on operator startup

Release 0.16.1

This is a bugfixing release with a number of internal changes:

  • CRD definition of Status has been modified. Note: CRD needs to be updated with this release
  • Default terminationGracePeriod for ClickHouse pod templates was moved to operator configuration. Default is 30 seconds as in 0.15.0 and before.
  • Improved installation templates
  • Fixed a bug with replicas not being correctly added when CHI has been modified from a Python Kubernetes client.

Upgrade notes:

  • CRD needs to be updated with this release
  • 0.16.0 had hardcoded 60 seconds for terminationGracePeriod that resulted in ClickHouse restarts when upgrading from 0.15.0 to 0.16.0. Upgrade from 0.15.0 to 0.16.1 does result in ClickHouse restarts. If you are upgrading from 0.16.0 to 0.16.1 set terminationGracePeriod to 60 in operator config file. Refer to Operator Configuration for more details.

Release 0.16.0

New features:

  • PodDisruption budget is configured automatically in order to prevent multiple pods being shut down by k8s
  • topologyKey is now configurable. It addresses Altinity#772
  • spec.restart: "RollingRestart" attribute has been added in order to initiate graceful restart of a cluster. Use it with a patch command.
  • Added a support for Kubernetes secrets in settings section, e.g. for ClickHouse user/password.

Changed:

  • Pod maintenance logic during all operations that require pod restart has been improved:
    1. Wait condition is enabled for a pod to be removed from ClickHouse cluster.
    2. Wait condition is added for running queries to complete (up to 5 minutes).
    3. terminationGracePeriod has been increased to 60 seconds.
  • Timeout for DDL operations has been increased to 60 seconds. That addresses issues with schema management on slow clusters.
  • Base image is switched to RedHat UBI
  • ZooKeeper image version has been rolled back to 3.6.1 since we have some problems with 3.6.3
  • CRD apiVersion has been upgraded from apiextensions.k8s.io/v1beta1 to apiextensions.k8s.io/v1. The v1beta1 manifests are still available under descriptive names.

Fixed:

  • Fixed a bug with non-working custom ports
  • Fixed a bug with replicas being incorrectly deleted from ZooKeeper for retained volumes

Note: Upgrade from the previous version will result in restart of ClickHouse clusters.

Release 0.15.0

New features:

  • Added 90s delay before restarting the stateful set, when ClickHouse server settings are modified. That makes sure ClickHouse server starts with an updated configuration. Before that there was a race condition between configmap updates and statefulset restart. The default timeout can be modified by 'spec.reconciling.configMapPropagationTimeout' property. See example
  • Added 'troubleshooting' mode that allows pod to start even if ClickHouse server is failing. In troubleshooting mode liveness check is removed, and extra 'sleep' is added to the startup command. Controlled by 'spc.troubleshoot' property. See example
  • Added a cleanup reconcilation logic that will remove k8s object that are labeled by a particular CHI but do not exist in the CHI manifest. The default behaviour can be altered with 'spec.reconciling.cleanup.unknownObjects' . See example
  • ZooKeeper manifests have been modified to use 'standaloneEnabled=false' for single node setups as recommended in ZooKeeper documentation. ZooKeeper version has been bumped to 3.6.3

Bug fixes:

  • Fixed a bug when replica has not been deleted in ZooKeeper when scaling down (Altinity#735). The bug has been introduced in 0.14.0
  • Fixed a bug when PVCs modified outside of operator could be re-created during the reconcile (Altinity#730).
  • Fixed a bug when schema was not created on newly added replica sometimes

Release 0.14.0

New features:

  • Operator reconciles CHI with the actual state of objects in k8s. In previous releases it compared new CHI and old CHI, but not with k8s state.
  • The current reconcile cycle can be interrupted with a new CHI update now. In previous releases user had to wait until reconcile is complete for all nodes..
  • Added volumeClaimTemplate annotations. Closes Altinity#578
  • clickhouse_operator user/password can be stored in a secret instead of a configuration file. Closes: Altinity#386
  • Added 'excludeFromPropagationLabels' option
  • Added readiness check
  • LabelScope metrics are removed by default since it causes pods to restart when changing a cluster with circular replication. Closes: Altinity#666. If you need those labels, they can be turned on with 'appendScopeLabels' configuration option
  • Monitoring of detached parts
  • Operator ClusterRole is restricted. Closes Altinity#646
  • Logging improvements

Bug fixes:

  • Fixed a bug when CHI pods could get stuck in ErrImagePull status when wrong image has been used
  • Fixed a bug when operator tried to apply schema to non-existing pods, and entered a lengthy retry cycle

Upgrade notes:

  • Existing clusters will be restarted with the operator upgrade due to signature change
  • Due to ClusterRole change the upgrade with re-applying installation manifest may fail. See Altinity#684

Release 0.13.5

This is a follow-up release to 0.13.0:

Improvements:

  • Readiness check has been removed in favour of custom readiness controller, liveness check has been adjusted for slower startup times
  • Operator currently uses 'ready' label for graceful pods creation and modifications. That reduces possible service downtime
  • More graceful re-scale and other operations
  • New StatefulSet fingerprint
  • Operator log has been improved and properly annotated
  • Test suite has been upgraded to the recent TestFlows version

Note 1: We recommend using 0.13.5 instead of 0.13.0. We have found that implementation of liveness/readiness probes in 0.13.0 release was not optimal for healthy production operation. Note 2: ClickHouse clusters will be restarted after operator upgrade due to pod template and labels changes.

Release 0.13.0

New features:

  • Added liveness (/ping) and readiness (/replicas_status) probes to ClickHouse pods. Those can be overwritten on podTemplate level
  • Customizable graceful reconcile logic. Now it is possible to turn-on 'wait' behaviour that would apply configuration changes and upgrades using the following algorithm:
    • Host is (optionally) excluded from ClickHouse remote_servers
    • Operator (optionally) waits for exclusion to take an effect
    • Host is updated
    • If it is a new host, schema is created at this stage. That ensures host is not in the cluster until schema is created. Fixes #561
    • Host is added back to remote_servers
    • Operator (optionally) waits for inclusion to take an effect before moving to the next host.

'Optional' steps are turned-off by default and can be turned on in operator configuration:

reconcileWaitInclude: false
reconcileWaitExclude: false

or enabled for particular CHI update:

spec:
  reconciling:
    policy: "nowait"|"wait"
  • Cluster 'stop' operation now correctly removes CHI from monitoring and deletes LoadBalancer service
  • podTemplate metadata is now supported (annotations, labels). Fixes #554
  • 'auto' templates are now available. If templating.policy=auto is specified for ClickHouseInstallationTemplate object, those templates are automatically applied to all ClickHouseInstallations.
  • Minor changes to ClickHouse default profile settings.

Bug fixes:

  • External labels, annotations and finalizers are correctly preserved for services.
  • It was possible that finalizer has been inserted multiple times to CHI

Note:

existing ClickHouse clusters will be restarted after operator upgrade because of adding Liveness/Readiness probes

Release 0.12.0

This release includes a number of improvements in order to eliminate unneeded restarts and reduce service downtime:

  • Pods are no longer restarted when new shards/replicas are added
  • Cluster configuration (remote_servers.xml) is now updated after shards and replicas are added. That reduces a chance to get an error querying distributed tables.
  • LoadBalancer node ports are no longer modified on service upgrade. That reduces possible downtime
  • Service is re-created if it can not be updated for some reason (e.g. change from ClusterIP to LoadBalancer or vice versa)
  • Fixed several race conditions when creating/updating a cluster

Release 0.11.0

New features:

  • ClickHouse settings can be configured at shard/replica level
  • Custom ClickHouse configuration files may be supplied both for 'users.d' and 'config.d' sections using 'users.d/my_users.xml:' syntax.
  • Operator is registered as a finalizer for CHI, so CHI deletion is more reliable now.

Bug fixes:

  • Operator does not attempt to create a schema when cluster is rolled over initially anymore. Fixes #479 and may improve #478 as well
  • Schema creation logic when adding new shards/replicas has been improved to address #308
  • Operator restart should not cause ClickHouse pods restart anymore in most cases

Important Note: CHI can not be deleted without operator installed anymore. Also, if operator and CHI is installed in one namespace, and namespace is deleted, it may stuck forever in 'Terminating' state due to an arbitrary deletion sequence.

Release 0.10.0

General:

  • Kubernetes APIs used by operator have been updated to 1.15. Operator does not use features from new APIs, so it keeps working with Kubernetes 1.12 and above. Operator is tested for compatibility with different k8s versions, and we did not face any issues.

New features:

Bug fixes:

  • Set 'internal_replication' to false for single replica clusters (#422 by @yuzhichang)
  • Fixed schema creation logic when adding new replica (#385), improved stability in general for different types of objects
  • Service selectors did not include namespace, that could lead to a conflict in multi-namespace environment. It is fixed now.
  • Operator generated ClickHouse configuration files using standard names, like 'settings.xml'. It might lead to a conflict with user configuration files. Now all generated config files are prefixed with 'chop-generated-'.

Upgrade notes: When operator is upgraded from the previous version, it re-creates statefulsets and pods to ensure they match the installation. The storage should be correctly re-attached. As a side effect it ensures there are no backwards incompatibility issues between operator versions.

Release 0.9.9

Bug fixes:

  • Fixed ZooKeeper installation manifests that did not mount PV properly. The bug could result in ZooKeeper data loss if ZK pods were restarted.
  • Fixed metrics exporter to work across multiple ClickHouse versions -- metric descriptions are temporary removed, Prometheus does not work good if those change.

Other changes:

  • Bumped prometheus/golang_client to the latest version
  • Added extra logging into chi status field.

Release 0.9.8

Bug fixes:

  • Fixed multi-threading model for proper handling or concurrent updates
  • Fixed schema propagation logic to work with database names that require quoting

Other changes:

  • Disabled query_thread_log by default (only applies to new instances)

Release 0.9.7

Bug fixes:

  • Fixed a bug with schema management queries failing at ClickHouse 20.3.+
  • Fixed a bug with logging level configuration not being respected by metrics-exporter
  • Fixed schema management logic to use ClickHouse pods directly bypassing LoadBalancer service
  • Fixed a bug with host being deleted twice when deleting cluster or shards/replicas

Grafana dashboard has been also improved in this release.

Release 0.9.6

Bug fixes:

  • Sensitive data is masked now in operator logs
  • Fixed a bug with replicated tables being deleted even when PVC has been retained (#314)
  • Fixed a bug with annotations not being propagated to the pods (#289). Example 16-custom-labels-and-annotations-01.yaml

Documentation and examples has been updated to reflect recent changes.

Release 0.9.5

Bug fixes:

  • Fixed incorrect initialization of installation template in some cases

Improvements:

  • Added podDistribution.scope in order to control scope of anti-affinity rules

Release 0.9.4

Bug fixes:

  • Fixed regression with Zookeeper configuration (#310)
  • Fixed a bug in table_partitions metric export
  • Removed excessive logging in metrics exporter

Improvements:

  • Load balancer service now uses externalTrafficPolicy: Local by default
  • ZooKeeper configuration is currently supported per cluster level (#209 via #288)

Release 0.9.3

Bug fixes:

  • Fixed a problem with upgrading operator for ClickHouseInstallations created by operator 0.8.0 and earlier
  • Fixed a problem with updates to ClickHouse users configuration not always being propagated to ClickHouse servers (#282 )

Tweak:

  • Added operator log level configuration

IMPORTANT NOTES:

  1. Please upgrade operator via re-installation. There are change in resource definitions.
  2. Operator versions 0.9.1 and 0.9.2 are not compatible with 0.9.0 and 0.9.3 in regards to upgrade. Clusters created with those versions have to be re-created.

Release 0.9.2

Bug fixes:

  • Fixed memory leak in metrics exporter (#176)

Release 0.9.1

Bug fixes

  • Fixed regression with 'files' section of configuration (#261)
  • Fixed discovery of monitored ClickHouse clusters by metrics exporter when it is being restarted (#239)

Release 0.9.0

New features:

  • Option to define template per ClickHouse replica (before it was only possible to have global, shard based or
  • 'circular' replication shortcut (podDistribution.type: CircularReplication)
  • hostTemplates in order to propagate custom ports across configuration
  • hostNetwork support and portDistribution types. See examples starting from '14-' in examples folder. host based templates)
  • New Grafana dashboard

Release 0.8.0

New features:

Monitoring improvements:

  • ClickHouse mutations are now available in monitoring
  • Metrics fetch/error events were added
  • Fixed a bug with monitoring events not properly labeled (also fixes #225)
  • Fixed a bug when all hosts were dropped out of monitoring if one host fails

Other bug fixes:

  • Fixed a bug when schema could not be created automatically on newer versions of ClickHouse (#227).
  • Fixed a bug with zookeeper root entry not propagated to ClickHouse configuration

Upgrade notes:

  • There were changes in ClickHouseInstallation CRD. It is recommended to remove and re-install the operator. Existing ClickHouse clusters will be picked up automatically.
  • IMPORTANT: If you upgrade operator from 0.6.0 or earlier to 0.8.0 please make sure your ClickHouseInstallation name is shorter than 15 symbols. Otherwise DO NOT UPGRADE an operator.

Release 0.7.0

New features:

  • Added 'podVolumeClaimTemplate' and 'logVolumeClaimTemplate' in order to map data and logs separately. Old syntax is deprecated but supported.
  • Sidecar clickhouse-logs container to view logs
  • Significantly cleaned up templates model and 'useTemplates' extension
  • new system_replicas_is_session_expired monitoring metric (#187 by @teralype)

Bug fixes:

  • Fixed bug with installation name being truncated to 15 chars. The current limit is 60 chars. Cluster name is limited to 15.
  • General stability improvements and fixes for corner cases

Upgrade notes: There were changes in ClickHouseInstallation CRD, so it is recommended to remove and re-install the operator. Existing ClickHouse clusters will be picked up automatically.

Release 0.6.0

New features:

  • Added spec.stop property to start/stop all ClickHouse pods in installation for maintenance
  • ClickHouseInstallationTemplate custom resource definition
  • ClickHouseOperatorConfiguration custom resource definition

Improvements:

  • Split operator into two binaries/containers - operator and monitor
  • Added 10 second timeout for queries to ClickHouse (#159 by @kcking)
  • Improved create/update logic
  • Operator now looks at its own namespace if not specified explicitly
  • Enhance multi-thread support for concurrent operations