Skip to content

Latest commit

 

History

History
90 lines (55 loc) · 4.33 KB

create-a-serverless-cluster.md

File metadata and controls

90 lines (55 loc) · 4.33 KB
title summary toc redirect_from docs_area
Create a CockroachDB Serverless Cluster
Learn how to create a cluster using CockroachDB Serverless.
true
create-a-free-cluster.html
deploy

{% include cockroachcloud/filter-tabs/create-cluster-cloud.md %}

This page walks you through the process of creating a cluster using {{ site.data.products.serverless }}. Note that only {{ site.data.products.db }} Console Administrators can create clusters. If you are a Developer and need to create a cluster, contact your {{ site.data.products.db }} Administrator.

Before you begin

If you haven't already, sign up for a {{ site.data.products.db }} account.

Step 1. Start the cluster creation process

  1. Log in to your {{ site.data.products.db }} account. {% include cockroachcloud/prefer-sso.md %}
  2. If there are multiple organizations in your account, select the correct organization in the top right corner.
  3. On the Overview page, click Create Cluster.

Step 2. Select a cloud provider & region

  1. (Optional) Select a cloud provider (GCP or AWS) in the Cloud provider section.

  2. (Optional) Select a region in the Regions section. For optimal performance, select the cloud provider region closest to the region in which you are running your application.

Step 3. Enter a spend limit

Every cluster starts with 10M RUs of free burst capacity each month and earns 100 RUs per second up to a maximum of 250M free RUs per month. Earned RUs can be used immediately or accumulated as burst capacity. If you use all of your burst capacity, your cluster will revert to baseline performance.

If you set a spend limit, your cluster will not be throttled to baseline performance once you use all of your free earned RUs. Instead, it will continue to use burst performance as needed until you reach your spend limit. You will only be charged for the resources you use up to your spend limit. If you reach your spend limit, your cluster will revert to the baseline performance of 100 RUs per second.

{% include cockroachcloud/serverless-usage.md %}

{{site.data.alerts.callout_info}} Regardless of whether you set a spend limit, adding billing information for your organization allows you to use cloud storage for bulk operations. Organizations without billing information are limited to using userfile storage for bulk operations. {{site.data.alerts.end}}

Free Paid
  1. Click Create cluster.

Your cluster will be created in a few seconds.

  1. Enter your Spend limit.

    This is the maximum amount you could be charged per month. You will be charged only for what you use.

  2. Click Next: Payment info.

  3. Verify your cluster configuration and spend limit.

    {{site.data.alerts.callout_info}} The cost displayed does not include taxes. {{site.data.alerts.end}}

  4. Add your preferred payment method.

  5. Click Create cluster.

Your cluster will be created in a few seconds.

What's next

Usage examples

Free {{ site.data.products.serverless }} clusters can be used for proofs-of-concept, toy programs, or to use while completing Cockroach University.

For examples of applications that use free {{ site.data.products.db }} clusters, check out the following Hack the North projects: