Clusters Overview

    Clusters are managed deployments of Couchbase Server.

    In Couchbase Cloud, a cluster is a managed deployment of Couchbase Server. A cluster consists of one or more instances of Couchbase Server, each running on an independent node.

    In the Couchbase Cloud hierarchy, clusters are contained within projects, and deployed on clouds.


    A cluster is made up of one or more services. Couchbase services are what allow you to access and maintain your data.

    The following services are available:

    Service Description

    Data Service

    Supports the storing, setting, and retrieving of data-items, specified by key.

    All clusters must run the Data Service. The Data Service must run on at least one node of every cluster. However, at least three nodes are required for production environments. (Clusters with fewer than three Data nodes have several limitations.)

    Refer to Data Service.

    Query Service

    Parses queries specified in the N1QL query-language, executes the queries, and returns results. The Query Service interacts with both the Data and Index Services.

    Refer to Query Service.

    Index Service

    Creates indexes, for use by the Query Service.

    Refer to Index Service.

    Search Service

    Create indexes specially purposed for Full Text Search. This supports language-aware searching, allowing users to search for, say, the word beauties, and additionally obtain results for beauty and beautiful.

    Refer to Search Service.

    Analytics Service

    Supports join, set, aggregation, and grouping operations, which are expected to be large, long-running, and highly consumptive of memory and CPU resources.

    Refer to Analytics Service.

    Eventing Service

    Supports near real-time handling of changes to data: code can be executed both in response to document-mutations, and as scheduled by timers.

    Refer to Eventing Service.

    Deploying Services

    Each instance of a service runs on its own service configuration. A service configuration includes the Couchbase services that will be deployed on a cluster node, as well as the system resources (such as compute and storage) of the cloud VM that the node will be deployed with. Each service configuration will also have a node quantity, which represents the number of nodes in the cluster that will have that configuration.

    Each service can be deployed, maintained, and provisioned independently of one another. This is sometimes referred to as Multi-Dimensional Scaling, and it allows you to do things like:

    • Deploy different services with different virtual machine types.

      For example, deploying the Data Service on VMs that have a large amount of memory, while deploying the Index Service on VMs that have a very high storage I/O rating.

    • Scale a service up or down by adding or removing virtual machines.

      For example, if resource capacity is running low for one of the services, you can add another VM to increase capacity.

    • Scale a service up or down by changing the virtual machine type of an existing VM.

      For example, if you find that a service has a lot of excess resource capacity, you can change the VM type to one with lower capacity.

    Couchbase Versions

    By default, new clusters will deploy with the latest stable version of Couchbase Server (currently 6.5.1).

    Administrating Clusters

    Refer to the following pages for more information on managing clusters: