Provision an Aerospike Cloud database cluster

You can provision Aerospike Cloud database clusters through the Cloud console or with the Cloud APIs. This guide includes the steps for doing both.

Prerequisites

• You have already set up an Aerospike Cloud account
• Your Aerospike Cloud account has been granted node entitlements by Aerospike

Provision a cluster

Console

1. Navigate to the clusters page.

   Click Provision cluster.

2. Follow the prompts. Choose the options that suit your needs.

   If a region or instance type you need is unavailable reach out to support or your Sales Engineer.

   Note

   Strong Consistency (SC) is only available with local storage during preview.

3. Choose instance size.

   Here you can choose which cloud instance type should provide the underlying infrastructure for your Aerospike database cluster.

   Note

   You may select instance types with disk space for in-memory only Aerospike database clusters but the disks will not be utilized.

   You may not choose instance type without disk storage space for a local-disk storage Aerospike database cluster.

4. Advanced configuration.

   This step may be skipped during quick start; all necessary fields will be populated for you. If you wish to learn more about Advanced configuration check out this guide.

5. Review and launch

   Finalize your selections match what you want and launch the cluster.

API

1. Create a Cloud API key and retrieve a bearer token. See Using Cloud APIs for how to create a key to use with the API.

2. Make a POST request with a database spec. Example:

   curl -X POST "https://api.aerospike.cloud/v2/databases" \
       -H "Authorization: Bearer <bearer-token>" \
       -H "Content-Type: application/json" \
       --data '{"name":"my-first-cluster","infrastructure":{"provider":"aws","instanceType":"i4i.large","region":"us-east-1","availabilityZoneCount":2},"aerospikeCloud":{"clusterSize":2,"dataStorage":"memory"},"aerospikeServer":{"namespaces":[{"name":"test"}]}}'

Notes

• Aerospike Cloud provisions new Cloud infrastructure for every database cluster. The time it takes to create that infrastructure varies by cloud provider and resource type. In Preview, AWS is the only cloud provider available. It takes about 20 minutes to fully provision a new database cluster, with some variation by region and specific configuration.
• During provisioning time, you can create your first database user or configure your VPC peering connection.
• You can use the CIDR range provided by the cluster to choose an application CIDR that will not conflict and prepare for VPC peering on the application side.
• Aerospike Cloud queues peering and user operations, completing them as soon as the database cluster is active and healthy.