From a071f317a6eed0492db5cd1318cf7169f448adfd Mon Sep 17 00:00:00 2001 From: Cheng Weiwei <65707268+wildpcww@users.noreply.github.com> Date: Mon, 24 Aug 2026 12:09:54 +0800 Subject: [PATCH 1/2] Single AZ support --- tidb-cloud/architecture-concepts.md | 2 ++ tidb-cloud/byoc/byoc-initialize-service.md | 4 ++-- tidb-cloud/byoc/byoc-prepare-environment-aws.md | 6 +++--- tidb-cloud/byoc/create-resource-pool-byoc.md | 17 ++++++++++++----- tidb-cloud/byoc/create-tidb-instance-byoc.md | 2 +- tidb-cloud/byoc/manage-resource-pools-byoc.md | 1 + tidb-cloud/byoc/multi-region-deployment.md | 2 +- .../premium/backup-and-restore-premium.md | 4 ++-- 8 files changed, 24 insertions(+), 14 deletions(-) diff --git a/tidb-cloud/architecture-concepts.md b/tidb-cloud/architecture-concepts.md index 763828faf26c3..81fefae04d5ce 100644 --- a/tidb-cloud/architecture-concepts.md +++ b/tidb-cloud/architecture-concepts.md @@ -104,6 +104,8 @@ BYOC provides the following features: To meet different workload requirements, TiDB Cloud BYOC supports both Single-AZ and Multi-AZ deployments, enabling you to choose between lower-latency zonal deployment and higher-resilience deployment across multiple availability zones. +High availability is configured for each resource pool. A Zonal resource pool is deployed in a single availability zone, while a Regional resource pool is deployed across multiple availability zones. TiDB Cloud determines the availability zone placement based on the BYOC region configuration and available cloud resources. Instances created or restored in a resource pool inherit its high availability mode. After a resource pool is created, you cannot change its high availability mode or availability zone placement. + ![TiDB Cloud BYOC Architecture](/media/tidb-cloud/byoc-architecture.png) A TiDB Cloud BYOC deployment includes the following major components: diff --git a/tidb-cloud/byoc/byoc-initialize-service.md b/tidb-cloud/byoc/byoc-initialize-service.md index e2b5fa8f01f4e..7348810a9c3e6 100644 --- a/tidb-cloud/byoc/byoc-initialize-service.md +++ b/tidb-cloud/byoc/byoc-initialize-service.md @@ -11,7 +11,7 @@ After deploying your BYOC infrastructure, create a resource pool, create your fi You can now provision resource pools and TiDB instances directly via the TiDB Cloud console. -1. Create a resource pool. Log in to the [TiDB Cloud console](https://tidbcloud.com/) and follow the instructions in [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md) to create a resource pool in the target cloud provider and region. +1. Create a resource pool. Log in to the [TiDB Cloud console](https://tidbcloud.com/) and follow the instructions in [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md) to create a resource pool in the target cloud provider and region. When creating the resource pool, select Zonal or Regional high availability based on your workload requirements. Instances created or restored in the resource pool inherit its high availability mode. 2. After the resource pool becomes **Active**, follow the instructions in [Create a {{{ .byoc }}} Instance](/tidb-cloud/byoc/create-tidb-instance-byoc.md) to create a new instance in the resource pool. @@ -34,7 +34,7 @@ After preparing your backup file in Amazon S3, you can restore the data to a new Once the access keys are configured, you can initiate the restore job from the TiDB Cloud console. - During restore, select an active resource pool in the target cloud provider and region. + During restore, select an active resource pool in the target cloud provider and region. The restored instance inherits the high availability mode of the selected resource pool. For step-by-step restoration procedures, see [Restore backups from cloud storage](/tidb-cloud/premium/backup-and-restore-premium.md#restore-backups-from-cloud-storage). diff --git a/tidb-cloud/byoc/byoc-prepare-environment-aws.md b/tidb-cloud/byoc/byoc-prepare-environment-aws.md index eb18dfcec3ac0..803813775df5b 100644 --- a/tidb-cloud/byoc/byoc-prepare-environment-aws.md +++ b/tidb-cloud/byoc/byoc-prepare-environment-aws.md @@ -37,9 +37,9 @@ TiDB is a distributed database that requires specific infrastructure for high av - **Option B: POC / Cost Optimization (Single-AZ).** Select exactly **1 AZ**. For example, `us-west-2a`. - > **Note:** - > - > Multi-AZ deployment functionality is disabled for this configuration. +The availability zones prepared for the BYOC region determine where TiDB Cloud can place resource pools. When creating a resource pool, you select either Zonal or Regional high availability. A Zonal resource pool is placed in one availability zone. A Regional resource pool requires at least three eligible availability zones in the region. + +If the BYOC region is initially prepared with a single availability zone, TiDB Cloud uses that availability zone for Zonal resource pools. You can create a Regional resource pool only when two additional eligible availability zones are available. If you plan to use Regional resource pools, confirm during environment preparation that the region can provide at least three eligible availability zones. ## Step 4. Create a hosted zone for TiDB diff --git a/tidb-cloud/byoc/create-resource-pool-byoc.md b/tidb-cloud/byoc/create-resource-pool-byoc.md index c7f90b91b53aa..e38ed78a754d1 100644 --- a/tidb-cloud/byoc/create-resource-pool-byoc.md +++ b/tidb-cloud/byoc/create-resource-pool-byoc.md @@ -48,7 +48,18 @@ To create a resource pool, take the following steps: If you set a Pool vCPU Limit, make sure that the total vCPUs of the initial TiKV and TiFlash resources do not exceed 50% of the Pool vCPU Limit. This helps reserve capacity for future instance creation and automatic scale-out. -6. In the **Pool CIDR** area, review or enter the CIDR range for the resource pool. +6. In the **High Availability** area, select a high availability mode for the resource pool. + + - **Zonal**: deploys the resource pool in a single availability zone for lower network latency. + - **Regional**: deploys the resource pool across multiple availability zones for higher availability and resilience against an availability-zone-level outage. + + You must select a high availability mode before creating the resource pool. You cannot select the specific availability zones. TiDB Cloud determines the availability zones based on the BYOC region configuration and available cloud resources. + + To create a Regional resource pool, at least three eligible availability zones must be available in the region. If this requirement is not met, you cannot create the Regional resource pool. + + After the resource pool is created, you cannot change its high availability mode or availability zone placement. + +7. In the **Pool CIDR** area, review or enter the CIDR range for the resource pool. The resource pool CIDR is used as the network address range for resources in the resource pool and cannot be modified after the resource pool is created. @@ -61,10 +72,6 @@ To create a resource pool, take the following steps: TiDB Cloud validates CIDR overlap with known TiDB Cloud managed network ranges in the target region. TiDB Cloud cannot detect overlap with your application VPCs, on-premises networks, or VPN networks. You must verify these customer-managed network ranges before creating the resource pool. -7. In the **High Availability** area, review the high availability mode. - - The high availability mode is inherited from the BYOC deployment configuration of the selected region. You cannot change it when creating a Resource Pool. - 8. (Optional) In the **AWS Resource Tags** area, add tags. Tags are applied to all taggable AWS resources within the resource pool. diff --git a/tidb-cloud/byoc/create-tidb-instance-byoc.md b/tidb-cloud/byoc/create-tidb-instance-byoc.md index b5088eed497f3..c51a635ff8af8 100644 --- a/tidb-cloud/byoc/create-tidb-instance-byoc.md +++ b/tidb-cloud/byoc/create-tidb-instance-byoc.md @@ -51,7 +51,7 @@ If you have the required permissions, you can create a {{{ .byoc }}} instance as 7. In the **Capacity** area, set the maximum number of Request Capacity Units (RCUs) for your instance. RCUs represent the compute resources provisioned for your workload. TiDB Cloud automatically scales your instance within this range based on demand. -8. For {{{ .byoc }}} instances, the high availability mode is inherited from the selected resource pool. If the resource pool uses regional high availability, the instance uses regional high availability. If the resource pool uses zonal high availability, the instance uses zonal high availability. You cannot configure the high availability mode when you create a BYOC instance. For more information, see [High Availability](/tidb-cloud/serverless-high-availability.md). +8. For {{{ .byoc }}} instances, the high availability mode is inherited from the selected resource pool. If the resource pool uses Regional high availability, the instance uses Regional high availability. If the resource pool uses Zonal high availability, the instance uses Zonal high availability. You cannot configure the high availability mode when you create a BYOC instance. For more information, see [TiDB Cloud BYOC architecture](/tidb-cloud/architecture-concepts.md#tidb-cloud-byoc). 9. Click **Create**. diff --git a/tidb-cloud/byoc/manage-resource-pools-byoc.md b/tidb-cloud/byoc/manage-resource-pools-byoc.md index 7dd242c5fe2dd..e246dd10682ca 100644 --- a/tidb-cloud/byoc/manage-resource-pools-byoc.md +++ b/tidb-cloud/byoc/manage-resource-pools-byoc.md @@ -43,6 +43,7 @@ To view resource pool details, click the name of a resource pool on the **Resour The resource pool details page includes the following information: +- **High Availability**: shows whether the resource pool uses Zonal or Regional high availability. This value is read-only. You cannot change the high availability mode or availability zone placement after the resource pool is created. - **Pool vCPU Usage**: shows the current provisioned TiDB vCPU and additional vCPU provision. - **Instances in This Pool**: lists the BYOC instances that run in this resource pool. - **Metrics**: shows vCPU usage and physical storage usage trends. diff --git a/tidb-cloud/byoc/multi-region-deployment.md b/tidb-cloud/byoc/multi-region-deployment.md index a6d1e2529a508..aa84c463abf93 100644 --- a/tidb-cloud/byoc/multi-region-deployment.md +++ b/tidb-cloud/byoc/multi-region-deployment.md @@ -121,7 +121,7 @@ Use `tidbcloud-byoc-update.sh` to update the existing CloudFormation stacks. The Before running the update script: 1. Confirm the AWS Regions to be added. -2. Select the Availability Zones for the new regions. +2. Select the Availability Zones for the new regions. A Regional resource pool requires at least three eligible availability zones. If you plan to create Regional resource pools in a new region, confirm that the region can provide at least three eligible availability zones. 3. Plan the O11Y CIDR for each new region and the resource pool CIDRs for the resource pools you plan to create. Different regions can use the same O11Y CIDR. However, if you use metric integration to connect Grafana to multiple regions, use non-overlapping O11Y CIDRs for those regions. 4. Confirm whether each new region will: * share the existing PCA and TiDB hosted zone, or diff --git a/tidb-cloud/premium/backup-and-restore-premium.md b/tidb-cloud/premium/backup-and-restore-premium.md index 726537382f731..e8d137bd25d86 100644 --- a/tidb-cloud/premium/backup-and-restore-premium.md +++ b/tidb-cloud/premium/backup-and-restore-premium.md @@ -242,7 +242,7 @@ To restore your data to a new {{{ .premium }}} or {{{ - For {{{ .byoc }}}, select an active resource pool in the same cloud provider and region as the backup. If no suitable resource pool is available, an `Organization Owner` can create one before restoring the instance. Other roles cannot create resource pools. For more information, see [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md). + For {{{ .byoc }}}, select an active resource pool in the same cloud provider and region as the backup. The restored instance inherits the high availability mode of the selected resource pool. You can restore the same backup to a Zonal or Regional resource pool if the resource pool meets the restore requirements. If no suitable resource pool is available, an `Organization Owner` can create one before restoring the instance. Other roles cannot create resource pools. For more information, see [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md). @@ -366,7 +366,7 @@ To restore backups from cloud storage, do the following: - For {{{ .byoc }}}, select an active resource pool that matches the target cloud provider and region. If no suitable resource pool is available, an `Organization Owner` can create one before restoring the instance. Other roles cannot create resource pools. For more information, see [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md). + For {{{ .byoc }}}, select an active resource pool that matches the target cloud provider and region. The restored instance inherits the high availability mode of the selected resource pool. You can restore the same backup to a Zonal or Regional resource pool if the resource pool meets the restore requirements. If no suitable resource pool is available, an `Organization Owner` can create one before restoring the instance. Other roles cannot create resource pools. For more information, see [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md). From 2c98237fd867e3db0aa13e86a4be8d5f826bcd6a Mon Sep 17 00:00:00 2001 From: Cheng Weiwei <65707268+wildpcww@users.noreply.github.com> Date: Mon, 24 Aug 2026 14:33:42 +0800 Subject: [PATCH 2/2] update create instance with limit content --- tidb-cloud/byoc/byoc-initialize-service.md | 2 +- tidb-cloud/byoc/create-tidb-instance-byoc.md | 6 ++++++ tidb-cloud/byoc/manage-resource-pools-byoc.md | 6 ++++++ tidb-cloud/premium/backup-and-restore-premium.md | 12 ++++++++++++ 4 files changed, 25 insertions(+), 1 deletion(-) diff --git a/tidb-cloud/byoc/byoc-initialize-service.md b/tidb-cloud/byoc/byoc-initialize-service.md index 7348810a9c3e6..bf71eb816de96 100644 --- a/tidb-cloud/byoc/byoc-initialize-service.md +++ b/tidb-cloud/byoc/byoc-initialize-service.md @@ -34,7 +34,7 @@ After preparing your backup file in Amazon S3, you can restore the data to a new Once the access keys are configured, you can initiate the restore job from the TiDB Cloud console. - During restore, select an active resource pool in the target cloud provider and region. The restored instance inherits the high availability mode of the selected resource pool. + During restore, select an active resource pool in the target cloud provider and region. The restored instance inherits the high availability mode of the selected resource pool. Make sure that the resource pool has sufficient vCPU capacity, because restoring an instance might cause the total provisioned vCPU to exceed the Pool vCPU Limit and degrade the performance of all instances in the resource pool. If the resource pool has reached its Pool vCPU Limit, increase or turn off the limit, or select another resource pool before continuing. For step-by-step restoration procedures, see [Restore backups from cloud storage](/tidb-cloud/premium/backup-and-restore-premium.md#restore-backups-from-cloud-storage). diff --git a/tidb-cloud/byoc/create-tidb-instance-byoc.md b/tidb-cloud/byoc/create-tidb-instance-byoc.md index c51a635ff8af8..c99772238623f 100644 --- a/tidb-cloud/byoc/create-tidb-instance-byoc.md +++ b/tidb-cloud/byoc/create-tidb-instance-byoc.md @@ -49,6 +49,12 @@ If you have the required permissions, you can create a {{{ .byoc }}} instance as Only resource pools that match the selected cloud provider and region and are in the **Active** status are displayed. If no suitable resource pool is available and you are an `Organization Owner`, click **Create Resource Pool** to create one. After the resource pool becomes active, it is automatically selected for the new instance. + If the selected resource pool has a Pool vCPU Limit and its current provisioned vCPU is greater than or equal to the limit, TiDB Cloud displays a warning and you cannot create the instance in that resource pool. To continue, go to the Resource Pool details page to increase or turn off the Pool vCPU Limit, or select another resource pool. + + > **Important:** + > + > Even if the current provisioned vCPU is below the Pool vCPU Limit, creating a new instance might cause the total provisioned vCPU to exceed the limit. This might constrain resource scaling and degrade the performance of all instances in the resource pool. Before creating the instance, make sure that the resource pool has sufficient vCPU capacity. If necessary, increase or turn off the Pool vCPU Limit, or select another resource pool. + 7. In the **Capacity** area, set the maximum number of Request Capacity Units (RCUs) for your instance. RCUs represent the compute resources provisioned for your workload. TiDB Cloud automatically scales your instance within this range based on demand. 8. For {{{ .byoc }}} instances, the high availability mode is inherited from the selected resource pool. If the resource pool uses Regional high availability, the instance uses Regional high availability. If the resource pool uses Zonal high availability, the instance uses Zonal high availability. You cannot configure the high availability mode when you create a BYOC instance. For more information, see [TiDB Cloud BYOC architecture](/tidb-cloud/architecture-concepts.md#tidb-cloud-byoc). diff --git a/tidb-cloud/byoc/manage-resource-pools-byoc.md b/tidb-cloud/byoc/manage-resource-pools-byoc.md index e246dd10682ca..96cb8b9e9d224 100644 --- a/tidb-cloud/byoc/manage-resource-pools-byoc.md +++ b/tidb-cloud/byoc/manage-resource-pools-byoc.md @@ -80,6 +80,12 @@ To update the Pool vCPU Limit, take the following steps: When you set a new Pool vCPU Limit, the value must be greater than or equal to `100` vCPU and the current provisioned TiDB vCPU. Otherwise, the update is rejected. +> **Important:** +> +> Even when the current provisioned vCPU is below the Pool vCPU Limit, creating or restoring an instance might cause the total provisioned vCPU to exceed the limit. This might constrain resource scaling and degrade the performance of all instances in the resource pool. Before creating or restoring an instance, make sure that the resource pool has sufficient vCPU capacity. + +If the current provisioned vCPU of a resource pool is greater than or equal to its Pool vCPU Limit, you cannot create or restore an instance in that resource pool. To create or restore an instance, increase or turn off the Pool vCPU Limit, or select another resource pool. + If the resource pool is in the **Modifying** status, **Update vCPU Limit** is disabled. ## Update capacity diff --git a/tidb-cloud/premium/backup-and-restore-premium.md b/tidb-cloud/premium/backup-and-restore-premium.md index e8d137bd25d86..dc3181d83056c 100644 --- a/tidb-cloud/premium/backup-and-restore-premium.md +++ b/tidb-cloud/premium/backup-and-restore-premium.md @@ -244,6 +244,12 @@ To restore your data to a new {{{ .premium }}} or {{{ For {{{ .byoc }}}, select an active resource pool in the same cloud provider and region as the backup. The restored instance inherits the high availability mode of the selected resource pool. You can restore the same backup to a Zonal or Regional resource pool if the resource pool meets the restore requirements. If no suitable resource pool is available, an `Organization Owner` can create one before restoring the instance. Other roles cannot create resource pools. For more information, see [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md). + If the selected resource pool has a Pool vCPU Limit and its current provisioned vCPU is greater than or equal to the limit, TiDB Cloud displays a warning and you cannot restore the instance to that resource pool. To continue, go to the Resource Pool details page to increase or turn off the Pool vCPU Limit, or select another resource pool. + + > **Important:** + > + > Even if the current provisioned vCPU is below the Pool vCPU Limit, restoring an instance might cause the total provisioned vCPU to exceed the limit. This might constrain resource scaling and degrade the performance of all instances in the resource pool. Before restoring the instance, make sure that the resource pool has sufficient vCPU capacity. If necessary, increase or turn off the Pool vCPU Limit, or select another resource pool. + > **Note:** @@ -368,6 +374,12 @@ To restore backups from cloud storage, do the following: For {{{ .byoc }}}, select an active resource pool that matches the target cloud provider and region. The restored instance inherits the high availability mode of the selected resource pool. You can restore the same backup to a Zonal or Regional resource pool if the resource pool meets the restore requirements. If no suitable resource pool is available, an `Organization Owner` can create one before restoring the instance. Other roles cannot create resource pools. For more information, see [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md). + If the selected resource pool has a Pool vCPU Limit and its current provisioned vCPU is greater than or equal to the limit, TiDB Cloud displays a warning and you cannot restore the instance to that resource pool. To continue, go to the Resource Pool details page to increase or turn off the Pool vCPU Limit, or select another resource pool. + + > **Important:** + > + > Even if the current provisioned vCPU is below the Pool vCPU Limit, restoring an instance might cause the total provisioned vCPU to exceed the limit. This might constrain resource scaling and degrade the performance of all instances in the resource pool. Before restoring the instance, make sure that the resource pool has sufficient vCPU capacity. If necessary, increase or turn off the Pool vCPU Limit, or select another resource pool. + If the backup information is incorrect, click **Previous** to return to the previous page, and then enter the correct information.