This page walks you through the process of creating a CockroachCloud cluster.
Before you begin
- Before creating a cluster, check that you have the correct organization selected. Click the drop down in the top right corner to select a specific organization.
- Only CockroachCloud Console Administrators can create clusters. If you are a Developer and need to create a cluster, contact your CockroachCloud Administrator.
Step 1. Access the Create new cluster page
- Log in to your CockroachCloud account.
- On the Overview page, click Create Cluster.
Step 2. Select the cloud provider
On the Create new cluster page, select either Google Cloud or AWS as your preferred cloud provider.
The choice of the cloud provider decides the price per node. For pricing comparison, refer to the following table:
|Hardware configuration||GCP Pricing (per node, per month)||AWS Pricing (per node, per month)|
Step 3. Select the region and number of nodes
Select the region
For optimal performance, select the cloud provider region in which you are running your application. For example, if your application is deployed in GCP's
us-east1 region, select
us-east1 for your CockroachCloud cluster.
Some regions in GCP and AWS might not be displayed in the Regions list. We run CockroachCloud in EKS and GKE - the managed Kubernetes offerings for AWS and GCP respectively - and support all regions that the offerings are available in. If a particular region is not available on the CockroachCloud console, that is due to the cloud provider not supporting the managed Kubernetes offering in that region. See list of EKS regions and list of GKE regions for details.
Known issue: In addition to the non-GKE regions, we had to temporarily disable the following 4 GCP regions due to GCP's technical limitations:
Select the number of nodes
- For single-region application development and testing, you may create a one-node cluster.
- For single-region production deployments, we recommend a minimum of three nodes. The number of nodes also depends on your storage capacity and performance requirements. See Example for further guidance.
- For multi-region deployments, contact us.
You cannot create a 2-node cluster because 2-replica configurations are less reliable than a single replica.
As of now, you can add a maximum of 24 nodes to your cluster. For larger configurations, contact us.
Step 4. Select the hardware configuration
The choice of hardware per node determines the cost, throughput, and performance characteristics of your cluster. To select the hardware configuration, consider the following factors:
|Capacity||Total raw data size you expect to store without replication.|
|Replication||The default replication factor for a CockroachCloud cluster is 3.|
|Buffer||Additional buffer (overhead data, accounting for data growth, etc.). If you are importing an existing dataset, we recommend you provision at least 50% additional storage to account for the import functionality.|
|Compression||The percentage of savings you can expect to achieve with compression. With CockroachDB's default compression algorithm, we typically see about a 40% savings on raw data size.|
|Transactions per second||Each vCPU can handle around 1000 transactions per second. Hence an
To change the hardware configuration after the cluster is created, you will have to contact us.
See Example for further guidance.
Step 5. Name the cluster
The cluster name must be 6-20 characters in length, and can include lowercase letters, numbers, and dashes (but no leading or trailing dashes).
After entering the cluster name, click Next.
Step 6. Enter your billing details
- On the Summary page, verify your selections for the cloud provider, region, number of nodes, and the hardware configuration per node.
- Verify the hourly estimated cost for the cluster.
You will be billed on the 1st and 15th of every month.Note:The cost displayed does not include taxes.
- Add your preferred payment method.
- If you haven't used it yet, enter the code
CRDB30in the Trial code box for a 30-day trial of CockroachCloud and click Apply.
- Click Create cluster.
Your cluster will be created in approximately 20-30 minutes.
Let's say we want to create a cluster to connect with an application with a requirement of 2000 TPS that is running on the Google Cloud Platform in the
Suppose the raw data amount we expect to store without replication is 500 GB. At 40% Compression, we can expect a savings of 200 GB. Then the amount of data we need to store is 300 GB.
Let's consider a storage buffer of 50% to account for overhead and data growth. Then net raw data amount to be stored is 450 GB.
With the default replication factor of 3, the total amount of data stored is (3 * 450GB) = 1350 GB.
To determine the number of nodes and the hardware configuration to store 1350 GB of data, refer to the table in Step 2. We can see that the best option to store 1350 GB of data is 9
Option 2 nodes.
Let's verify if 9
Option 2 nodes meet our performance requirements of 2000 TPS. 9
Option 2 nodes have (9*4) = 36 vCPUs. Since each vCPU can handle around 1000 TPS, 9
Option 2 nodes can meet our performance requirements.
Thus our final configuration is as follows:
|Number of nodes||9|