From d9f58b49cd7fec64a9fe98dd90ac28933248f83a Mon Sep 17 00:00:00 2001 From: Shaun Struwig <41984034+Blargian@users.noreply.github.com> Date: Thu, 9 Oct 2025 11:40:04 +0200 Subject: [PATCH 1/3] Add MBB doc --- .../automatic_scaling.md | 0 .../automatic_scaling/make_before_break.md | 41 ++++++++++++++++++ .../cloud/features/mbb/vertical_scaling.png | Bin 0 -> 69055 bytes static/sample.pdf | Bin 18810 -> 0 bytes 4 files changed, 41 insertions(+) rename docs/cloud/features/04_infrastructure/{ => automatic_scaling}/automatic_scaling.md (100%) create mode 100644 docs/cloud/features/04_infrastructure/automatic_scaling/make_before_break.md create mode 100644 static/images/cloud/features/mbb/vertical_scaling.png delete mode 100644 static/sample.pdf diff --git a/docs/cloud/features/04_infrastructure/automatic_scaling.md b/docs/cloud/features/04_infrastructure/automatic_scaling/automatic_scaling.md similarity index 100% rename from docs/cloud/features/04_infrastructure/automatic_scaling.md rename to docs/cloud/features/04_infrastructure/automatic_scaling/automatic_scaling.md diff --git a/docs/cloud/features/04_infrastructure/automatic_scaling/make_before_break.md b/docs/cloud/features/04_infrastructure/automatic_scaling/make_before_break.md new file mode 100644 index 00000000000..2a09fdb241f --- /dev/null +++ b/docs/cloud/features/04_infrastructure/automatic_scaling/make_before_break.md @@ -0,0 +1,41 @@ +--- +sidebar_position: 1 +sidebar_label: 'Make Before Break (MBB)' +slug: /cloud/features/mbb +description: 'Page describing Make Before Break (MBB) operations in ClickHouse Cloud' +keywords: ['Make Before Break', 'MBB', 'Scaling', 'ClickHouse Cloud'] +title: 'Make Before Break (MBB) operations in ClickHouse Cloud' +doc_type: 'guide' +--- + +import Image from '@theme/IdealImage'; +import mbb_diagram from '@site/static/images/cloud/features/mbb/vertical_scaling.png'; + +ClickHouse Cloud performs cluster upgrades and cluster scaling utilizing a **Make Before Break** (MBB) approach. +In this approach, new replicas are added to the cluster before removing old replicas from it. +This is as opposed to the break-first approach, where old replicas would first be removed, before adding new ones. + +The MBB approach has several benefits: +* Since capacity is added to the cluster before removal, the **overall cluster capacity does not go down** unlike with the break-first approach. Of course, unplanned events such as node or disk failures etc. can still happen in a cloud environment. +* This approach is especially useful in situations where the cluster is under heavy load as it **prevents existing replicas from being overloaded** as would happen with a break-first approach. +* Because replicas can be added quickly without having to wait to remove replicas first, this approach leads to a **faster, more responsive** scaling experience. + +The image below shows how this might happen for a cluster with 3 replicas where the service is scaled vertically: + +Example diagram for a cluster with 3 replicas which gets vertically scaled + +Overall, MBB leads to a seamless, less disruptive scaling and upgrade experience compared to the break-first approach previously utilized. + +With MBB, there are some key behaviors that users need to be aware of: + +1. MBB operations wait for existing workloads to finish on the current replicas before being terminated. + This period is currently set to 1 hour, which means that scaling or upgrades can wait up to one hour for a long-running query on a replica before the replica is removed. + Additionally, if a backup process is running on a replica, it is left to complete before the replica is terminated. +2. Due to the fact that there is a waiting time before a replica is terminated, there can be situations where a cluster might have more than the maximum number of replicas set for the cluster. + For example, you might have a service with 6 total replicas, but with an MBB operation in progress, 3 additional replicas may get added to the cluster leading to a total of 9 replicas, while the older replicas are still serving queries. + This means that for a period of time, the cluster will have more than the desired number of replicas. + Additionally, multiple MBB operations themselves can overlap, leading to replica accumulation. This can happen, for instance, in scenarios where several vertical scaling requests are sent to the cluster via the API. + ClickHouse Cloud has checks in place to restrict the number of replicas that a cluster might accumulate. +3. With MBB operations, system table data is kept for 30 days. This means every time an MBB operation happens on a cluster, 30 days worth of system table data is replicated from the old replicas to the new ones. + +If you are interested in learning more about the mechanics of MBB operations, please look at this [blog post](https://clickhouse.com/blog/make-before-break-faster-scaling-mechanics-for-clickhouse-cloud) from the ClickHouse engineering team. diff --git a/static/images/cloud/features/mbb/vertical_scaling.png b/static/images/cloud/features/mbb/vertical_scaling.png new file mode 100644 index 0000000000000000000000000000000000000000..41e609b1ff27854cf568a9f8eab8c0435216b59f GIT binary patch literal 69055 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 From 7f2d8ef0145963ee0fe9adbe1172d7d372ec058e Mon Sep 17 00:00:00 2001 From: Shaun Struwig <41984034+Blargian@users.noreply.github.com> Date: Thu, 9 Oct 2025 11:42:08 +0200 Subject: [PATCH 2/3] link automatic scaling page to new MBB page --- .../automatic_scaling/automatic_scaling.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/cloud/features/04_infrastructure/automatic_scaling/automatic_scaling.md b/docs/cloud/features/04_infrastructure/automatic_scaling/automatic_scaling.md index fd0972b4a62..056fa594ab1 100644 --- a/docs/cloud/features/04_infrastructure/automatic_scaling/automatic_scaling.md +++ b/docs/cloud/features/04_infrastructure/automatic_scaling/automatic_scaling.md @@ -38,10 +38,15 @@ For Enterprise tier services scaling works as follows: - Custom profiles (`highMemory` and `highCPU`) do not support vertical autoscaling or manual vertical scaling. However, these services can be scaled vertically by contacting support. :::note -Scaling in ClickHouse Cloud happens in what we call "Make Before Break" (MBB) approach. This adds one or more replicas of the new size before removing the old replicas, preventing any loss of capacity during scaling operations. By eliminating the gap between removing existing replicas and adding new ones, MBB creates a more seamless and less disruptive scaling process. It is especially beneficial in scale-up scenarios, where high resource utilization triggers the need for additional capacity, since removing replicas prematurely would only exacerbate the resource constraints. As part of this approach we wait up to an hour to let any existing queries complete on the older replicas before we will remove them. This balances the need for existing queries to complete, while at the same time ensuring that older replicas do not linger around for too long. +Scaling in ClickHouse Cloud happens in what we call a ["Make Before Break" (MBB)](/cloud/features/mbb) approach. +This adds one or more replicas of the new size before removing the old replicas, preventing any loss of capacity during scaling operations. +By eliminating the gap between removing existing replicas and adding new ones, MBB creates a more seamless and less disruptive scaling process. +It is especially beneficial in scale-up scenarios, where high resource utilization triggers the need for additional capacity, since removing replicas prematurely would only exacerbate the resource constraints. +As part of this approach, we wait up to an hour to let any existing queries complete on the older replicas before removing them. +This balances the need for existing queries to complete, while at the same time ensuring that older replicas do not linger around for too long. Please note that as part of this change: -1. Historical system table data will be retained for up to a maximum of 30 days as part of scaling events. In addition, any system table data older than December 19, 2024, for services on AWS or GCP and older than January 14, 2025, for services on Azure will not be retained as part of the migration to the new organization tiers. +1. Historical system table data is retained for up to a maximum of 30 days as part of scaling events. In addition, any system table data older than December 19, 2024, for services on AWS or GCP and older than January 14, 2025, for services on Azure will not be retained as part of the migration to the new organization tiers. 2. For services utilizing TDE (Transparent Data Encryption) system table data is currently not maintained after MBB operations. We are working on removing this limitation. ::: From e4f1f0279db970bd668ce22608b86971ca884321 Mon Sep 17 00:00:00 2001 From: Shaun Struwig <41984034+Blargian@users.noreply.github.com> Date: Thu, 9 Oct 2025 18:25:39 +0200 Subject: [PATCH 3/3] Adjust menu positioning --- .../{automatic_scaling.md => 01_auto_scaling.md} | 0 .../{make_before_break.md => 02_make_before_break.md} | 0 .../04_infrastructure/automatic_scaling/_category_.json | 5 +++++ 3 files changed, 5 insertions(+) rename docs/cloud/features/04_infrastructure/automatic_scaling/{automatic_scaling.md => 01_auto_scaling.md} (100%) rename docs/cloud/features/04_infrastructure/automatic_scaling/{make_before_break.md => 02_make_before_break.md} (100%) create mode 100644 docs/cloud/features/04_infrastructure/automatic_scaling/_category_.json diff --git a/docs/cloud/features/04_infrastructure/automatic_scaling/automatic_scaling.md b/docs/cloud/features/04_infrastructure/automatic_scaling/01_auto_scaling.md similarity index 100% rename from docs/cloud/features/04_infrastructure/automatic_scaling/automatic_scaling.md rename to docs/cloud/features/04_infrastructure/automatic_scaling/01_auto_scaling.md diff --git a/docs/cloud/features/04_infrastructure/automatic_scaling/make_before_break.md b/docs/cloud/features/04_infrastructure/automatic_scaling/02_make_before_break.md similarity index 100% rename from docs/cloud/features/04_infrastructure/automatic_scaling/make_before_break.md rename to docs/cloud/features/04_infrastructure/automatic_scaling/02_make_before_break.md diff --git a/docs/cloud/features/04_infrastructure/automatic_scaling/_category_.json b/docs/cloud/features/04_infrastructure/automatic_scaling/_category_.json new file mode 100644 index 00000000000..1c448ae10ae --- /dev/null +++ b/docs/cloud/features/04_infrastructure/automatic_scaling/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Automatic Scaling", + "collapsible": true, + "collapsed": true, +} \ No newline at end of file