From c4242c1861be90dad8a94e0f27630808e2fc17e2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 16 Jun 2026 13:24:23 +0000 Subject: [PATCH] docs: sync upstream clickhouse-operator docs updates --- .../guides/configuration.mdx | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/products/kubernetes-operator/guides/configuration.mdx b/products/kubernetes-operator/guides/configuration.mdx index 9f2cb468c..c9035aef4 100644 --- a/products/kubernetes-operator/guides/configuration.mdx +++ b/products/kubernetes-operator/guides/configuration.mdx @@ -87,6 +87,35 @@ spec: Operator can modify existing PVC only if the underlying storage class supports volume expansion. +## Cluster domain {#cluster-domain} + +`spec.clusterDomain` sets the Kubernetes DNS suffix the operator uses when it builds +the fully-qualified pod host names it writes into the ClickHouse server +configuration. It defaults to `cluster.local` and exists on both +`ClickHouseCluster` and `KeeperCluster`. + +```yaml +spec: + clusterDomain: cluster.local # default; override only for a custom domain +``` + +The operator addresses every pod through the headless Service as +`...svc.`. That suffix flows into +two parts of the generated configuration: + +- On a `ClickHouseCluster`, its value is used for the replica host names in + `remote_servers` (cross-replica and `Distributed` queries). +- On a `KeeperCluster`, its value builds the Keeper node host names that + ClickHouse uses for coordination. + + +Only override this when your cluster's `kubelet` runs with a `--cluster-domain` +other than `cluster.local`. If the value does not match the real cluster domain, +ClickHouse cannot resolve the Keeper and replica host names — coordination and +`Distributed` queries fail with DNS resolution errors. Set the **same** value on the +`ClickHouseCluster` and the `KeeperCluster` it references. + + ## Pod configuration {#pod-configuration} ### Automatic topology spread and affinity {#automatic-topology-spread-and-affinity}