From 4356b05097918669984ea45d815b85544151c1d4 Mon Sep 17 00:00:00 2001 From: micheleRP Date: Tue, 26 Aug 2025 18:58:22 -0600 Subject: [PATCH 1/3] DOC-854-ensure CPU and SSD headroom for GCP --- .../byoc/gcp/create-byoc-cluster-gcp.adoc | 4 ++++ .../pages/cluster-types/byoc/gcp/vpc-byo-gcp.adoc | 2 ++ modules/get-started/partials/gpq-quotas.adoc | 10 ++++++++++ 3 files changed, 16 insertions(+) create mode 100644 modules/get-started/partials/gpq-quotas.adoc diff --git a/modules/get-started/pages/cluster-types/byoc/gcp/create-byoc-cluster-gcp.adoc b/modules/get-started/pages/cluster-types/byoc/gcp/create-byoc-cluster-gcp.adoc index eb308fa4a..044cc2d79 100644 --- a/modules/get-started/pages/cluster-types/byoc/gcp/create-byoc-cluster-gcp.adoc +++ b/modules/get-started/pages/cluster-types/byoc/gcp/create-byoc-cluster-gcp.adoc @@ -8,6 +8,10 @@ NOTE: With standard BYOC clusters, Redpanda manages security policies and resour If your clients need to connect from different GCP regions than where your cluster will be deployed, you must enable global access during cluster creation using the Cloud API. To create a BYOC cluster with global access enabled, see xref:networking:byoc/gcp/enable-global-access.adoc[Enable Global Access]. +== Prerequisites + +include::partial$gpq-quotas.adoc[] + == Create a BYOC cluster . Log in to https://cloud.redpanda.com[Redpanda Cloud^]. diff --git a/modules/get-started/pages/cluster-types/byoc/gcp/vpc-byo-gcp.adoc b/modules/get-started/pages/cluster-types/byoc/gcp/vpc-byo-gcp.adoc index ddeab0dc4..7f167104d 100644 --- a/modules/get-started/pages/cluster-types/byoc/gcp/vpc-byo-gcp.adoc +++ b/modules/get-started/pages/cluster-types/byoc/gcp/vpc-byo-gcp.adoc @@ -21,6 +21,8 @@ If your clients need to connect from different GCP regions than where your clust * Only primary CIDR ranges are supported for the VPC. * Redpanda requires access to certain Google APIs, storage buckets, and service accounts. See <>. +include::partial$gpq-quotas.adoc[] + == Limitations * Existing clusters cannot be moved to a BYOVPC cluster. diff --git a/modules/get-started/partials/gpq-quotas.adoc b/modules/get-started/partials/gpq-quotas.adoc new file mode 100644 index 000000000..f451388ba --- /dev/null +++ b/modules/get-started/partials/gpq-quotas.adoc @@ -0,0 +1,10 @@ +=== GCP quotas + +Ensure at least three nodes of headroom in the relevant GCP quotas in the same region as your cluster. During maintenance, GKE may temporarily create extra nodes. Quotas such as vCPUs per VM family (for example, N2D) and Local SSD total per VM family (quota key: `LOCAL_SSD_TOTAL_GB_PER_VM_FAMILY`) are listed for each tier on the *Create BYOC cluster* page in the Redpanda Cloud UI. + +Headroom formulas: + +* vCPU spare = `3 x (vCPUs per node)` +* Local SSD spare (GB) = `3 x (Storage size per node in GB)` + +For example, with per-node storage *1610 GB* and instance type *n2d-standard-4* (4 vCPUs), keep *4830 GB* Local SSD and *12 vCPUs* of spare quota. \ No newline at end of file From 379781b706a3c4a9918559b6cf0f09b1b76072f8 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Fri, 29 Aug 2025 10:00:46 -0600 Subject: [PATCH 2/3] Update modules/get-started/partials/gpq-quotas.adoc Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- modules/get-started/partials/gpq-quotas.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/get-started/partials/gpq-quotas.adoc b/modules/get-started/partials/gpq-quotas.adoc index f451388ba..0de5c3d70 100644 --- a/modules/get-started/partials/gpq-quotas.adoc +++ b/modules/get-started/partials/gpq-quotas.adoc @@ -7,4 +7,4 @@ Headroom formulas: * vCPU spare = `3 x (vCPUs per node)` * Local SSD spare (GB) = `3 x (Storage size per node in GB)` -For example, with per-node storage *1610 GB* and instance type *n2d-standard-4* (4 vCPUs), keep *4830 GB* Local SSD and *12 vCPUs* of spare quota. \ No newline at end of file +For example, with per-node storage *1500 GB* (4 × 375 GB Local SSD) and instance type *n2d-standard-4* (4 vCPUs), keep *4500 GB* Local SSD and *12 vCPUs* of spare quota. \ No newline at end of file From 4ced7deee39233713ed73edebb8c507aafdc1a23 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Fri, 29 Aug 2025 10:01:46 -0600 Subject: [PATCH 3/3] Update modules/get-started/partials/gpq-quotas.adoc --- modules/get-started/partials/gpq-quotas.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/get-started/partials/gpq-quotas.adoc b/modules/get-started/partials/gpq-quotas.adoc index 0de5c3d70..4f545c71e 100644 --- a/modules/get-started/partials/gpq-quotas.adoc +++ b/modules/get-started/partials/gpq-quotas.adoc @@ -1,6 +1,6 @@ === GCP quotas -Ensure at least three nodes of headroom in the relevant GCP quotas in the same region as your cluster. During maintenance, GKE may temporarily create extra nodes. Quotas such as vCPUs per VM family (for example, N2D) and Local SSD total per VM family (quota key: `LOCAL_SSD_TOTAL_GB_PER_VM_FAMILY`) are listed for each tier on the *Create BYOC cluster* page in the Redpanda Cloud UI. +Ensure at least three nodes of headroom in the relevant GCP quotas in the same region as your cluster. During maintenance, Redpanda may temporarily create extra nodes. Quotas such as vCPUs per VM family (for example, N2D) and Local SSD total per VM family (quota key: `LOCAL_SSD_TOTAL_GB_PER_VM_FAMILY`) are listed for each tier on the *Create BYOC cluster* page in the Redpanda Cloud UI. Headroom formulas: