Create a Cluster

    +
    Create a cluster to store and access data in Couchbase Capella.

    This page walks you through the process of creating a Couchbase Capella cluster. If you want to learn how to modify an existing Capella cluster, see Modify a Cluster.

    To create and connect to a free 30-day Capella trial cluster, see Get Started with Couchbase Capella.

    Prerequisites

    Permissions Required
    You must have the Project Owner or Cluster Manager project role.
    • When creating a cluster, you must add it to a project. You can create a project before creating a cluster or during the cluster creation process if you have the Organization Owner or Project Creator organization role.

    • If you’re using a free trial, you cannot create more than one cluster, and the cluster configuration options are limited.

    Procedure

    1. Open the Clusters tab in the main navigation.

      1. Click Create a Cluster if this is the first cluster in your organization, or click Create Cluster in the upper-right corner of the page if there are existing clusters.

        This action opens the Create Cluster page.

        A view of the Create Cluster page.
    2. Choose your preferred Cloud Service Provider.

      Your choice of cloud provider affects the configuration options for your cluster, the geographic location of where you can deploy your cluster, and its operation costs.

      For details on the cloud service providers supported by Capella, see:

    3. Select a Region and CIDR Block.

      You can deploy clusters hosted by Couchbase to select regions in your chosen cloud provider.

      1. Using the Available Regions drop-down menu, choose the region where you want to create this cluster. Select regions are available for Google Cloud and AWS.

      2. In the CIDR Block field, enter an IP range in CIDR notation. In most cases, you can accept the default CIDR block.

    4. Select a Configuration.

      The Configuration area provides multiple ways to size and configure your cluster:

      Templates

      Open the Configuration Templates flyout by clicking the choose a template link near the top of the Configuration area. This flyout provides a menu of template options that you can apply to your cluster.

      Cluster templates provide pre-defined cluster configurations that are based on common workloads. Each template has a variety of different sizes, and selecting one will populate the entire cluster configuration for you.

      Read more about how to use templates.

      Custom Deployments

      You can create custom configurations that provide more granular control over sizing and service functionality. This option works well if you already have experience with Couchbase Server or want to re-create an existing Couchbase deployment using Couchbase Capella.

      1. Select the Services.

        In a Capella cluster, you assign Couchbase Server services to service groups. Service groups allow you to create node configurations for specified services. During the cluster creation process, a new cluster automatically has one service group with the Data Service (a required service).

        You can add more services to an existing group by clicking the service group’s drop-down menu and selecting the services you require. Alternatively, you can add more service groups by clicking Add Service Group.

      2. Select the number of Nodes.

        Configure each service group with a node quantity. Individual service groups can have between 2 and 27 nodes but cannot collectively exceed 27 in a cluster. The service group that includes the Data Service requires at least 3 nodes and must be a multiple of 3 when using multiple availability zones.

      3. Select the Compute.

        Provide each service group with compute instance type. A selected compute option dictates the number of vCPUs and memory provisioned for each node in a service group. Compute options depend on the chosen cloud provider.

      4. Select the Disk Type.

        • AWS: Choose between GP3 or IO2.

        • GCP: PD-SSD only.

      5. Select the Storage.

        In each service group, enter the amount of storage your cluster needs per node.

      6. Select the IOPS.

        • AWS: Enter the IOPS for each service group.

        • GCP: IOPS is not directly configurable. It’s set based on the amount of storage you’ve assigned to a service group (30 read and 30 write IOPS per GB).

      For more detailed information about the node configuration options available for each cloud provider, see the Capella GCP and AWS reference documentation.
    5. Choose a Plan.

      All clusters in an organization must be on a Service Plan. The Service Plan determines the level of human support a cluster can receive and what features and services it can support. While you can upgrade or downgrade the chosen plan for a given cluster, using a feature that is specific to a plan may prevent a downgrade. If you are using a free trial of Couchbase Capella, only the Basic Service Plan is available.

      For more information on Capella’s support levels, see the Capella Cloud Service Support Policy.

      If you have chosen the Developer Pro or Enterprise plans, you must select a Support Time Zone. You should include factors like when cluster administrators can interact with Couchbase Support staff when choosing this setting.

    6. Choose an Availability option.

      You have the option to have all cluster nodes in the same availability zone or distributed across multiple availability zones. In most cases, you can accept the default Multiple Availability Zones setting as it offers the highest availability.

    7. Choose a Project.

      Each cluster must belong to a project.

      Existing Project

      Use the Project drop-down menu to select an existing project in your organization.

      New Project

      Create a new project for your cluster by clicking + Add Project.

    8. (Optional) Customize the Cluster Name.

      Your new cluster is automatically assigned a generated name. This name appears in the Cluster Name field, where you can modify it as needed. As this isn’t the cluster’s hostname, you can change it at any time.

      Cluster names can only include letters, numbers, spaces, periods (.), dashes (-), and underscores (_).
    9. (Optional) Add a Description.

      In the Description field, you can add any notes or details that you want to record about the new cluster.

    10. Review your cluster’s configuration.

      With the new cluster configuration options now set, it’s ready to deploy. Review the summary of the new cluster configuration and its hourly cost in the pane on the right side of the page to ensure it meets your expectations.

      While you can change many cluster configuration options after deployment, there are some that you cannot. For a list of the configuration changes you can make to a deployed Capella cluster, see Modify a Cluster - Change Options.
    11. Deploy your cluster.

      1. Once you’re satisfied with the cluster configuration, choose between the Credits and Pay-As-You-Go billing options.

      2. Click Deploy.

        Capella will proceed with automatically deploying the cluster to your chosen cloud provider and region. This process will generally take up to 5 minutes to deploy, though it can take longer depending on certain factors such as cluster size and cloud provider performance. Leaving the Configuring Your Cluster page will not affect deployment progress; feel free to return to the cluster page at any time. You’ll receive a notification when the deployment is done.

        When returning to your cluster after it has successfully deployed, you will see the cluster’s Metrics tab.

    Create a Cluster in Own VPC

    This information is for anyone still using Couchbase Server 6.6, hosted in their own cloud provider’s VPC. It does not apply to Couchbase 7.0, hosted in Couchbase’s VPC and fully managed for you.

    For further information contact Couchbase.

    The easiest way to get started with Capella, our fully managed DBaaS, is hosting in Couchbase’s Cloud.

    Prerequisites

    Permissions Required
    You must have the Project Owner or Cluster Manager project role.
    • When creating a cluster, you must add it to a project. You can create a project before creating a cluster or during the cluster creation process if you have the Organization Owner or Project Creator organization role.

    • When using your own cloud account, you must have a connected cloud. You can connect a new cloud before creating a cluster or during the cluster creation process if you have the Organization Owner or Cloud Manager organization role. This is not a requirement if you’re using Capella’s fully-hosted option.

    • If you’re using a free trial, you cannot create more than one cluster, and the cluster configuration options are limited.

    Procedure

    1. Open the Clusters tab in the main navigation.

      1. Click Create a Cluster if this is the first cluster in your organization, or click Create Cluster in the upper-right corner of the page if there are existing clusters.

        This action opens the Create Cluster page.

        A view of the Create Cluster page.
    2. Select a cloud deployment type.

      You have the option of deploying a cluster that is hosted by Couchbase or by your own AWS or Azure cloud account.

      1. If it isn’t already selected, choose your own cloud account by clicking the Bring your own Cloud box.

    3. Select a cloud.

      Existing Cloud

      Use the Cloud drop-down menu to select an existing connected cloud.

      New Cloud

      Add a new connected cloud to deploy your cluster by clicking + New Cloud. For instructions to configure a new connected cloud, refer to Connect and Manage Clouds.

    4. Customize the configuration and resources for the cluster.

      The Configuration area provides multiple ways to size and configure your cluster:

      Templates
      1. Click the choose a template link to open the Configuration Templates flyout. This flyout allows you to choose from all of the available templates.

        Cluster templates provide pre-defined cluster configurations based on common workloads. Each template has a variety of different sizes, and selecting one will populate the entire cluster configuration for you.

        Read more about how to use templates.

      Custom Deployments

      You can create custom configurations that provide the most granular control over sizing and service functionality. This option works well if you already have experience with Couchbase Server or want to re-create an existing Couchbase deployment using Couchbase Capella.

      Read more about how to create a custom deployment.

    5. Choose a Plan for your cluster.

      All clusters in an organization must be on a Service Plan. The Service Plan determines the level of human support a cluster can receive and what features and services it can support. If you are using a free trial of Couchbase Capella for your own cloud, only the Free Trial Service Plan is available.

      For more information on Capella’s support levels, review the Capella Cloud Service Support Policy.
      1. Click on the block of the Service Plan you want to apply to the cluster you are creating.

        If you have chosen the Developer Pro or Enterprise plans, you must select a Support Time Zone.

      2. Use the Support Time Zone drop-down menu to choose the Support Time Zone that is appropriate for the cluster. You should include factors like when cluster administrators can interact with Couchbase Support staff when changing this setting.

    6. Select a project for your cluster.

      Existing Project

      Use the Select Project drop-down menu to select an existing project in your organization.

      New Project

      Create a new project for your cluster by clicking + Add Project.

    7. (Optional) Customize the cluster name.

      Your new cluster is automatically assigned a generated name. This name appears in the Cluster Name field, where you can modify it as needed. As this isn’t the cluster’s hostname, you can change the cluster name at any time.

      Cluster names can only include letters, numbers, spaces, periods (.), dashes (-), and underscores (_).
    8. (Optional) Add a description for the cluster.

      In the Description field, you can add any notes or details that you want to record about the new cluster.

    9. Review the new cluster’s configuration.

      Once you’ve specified a name, project, and description (optional) for the cluster, you are ready to deploy. Review the summary of the new cluster configuration in the pane on the right side of the page to ensure it meets your expectations. You can make any further changes directly on the Create Cluster page.

    10. Deploy the new cluster.

      Once you’re satisfied with the cluster configuration, click Deploy.

      Capella will proceed with automatically deploying the cluster to your selected cloud. This process will generally take up to 15 minutes to deploy, though it can take longer depending on certain factors such as cluster size and cloud provider performance. Leaving the Configuring Your Cluster page will not affect deployment progress; feel free to return to the cluster page at any time. You’ll receive a notification when the deployment is done.

      When returning to a cluster after it has successfully deployed, you will see the cluster’s Metrics tab.