GridGain Developers Hub

Creating a Managed Cluster

To provision a new managed cluster, click + on the main GridGain Nebula toolbar and select Create Managed Cluster.

The Create Managed cluster dialog opens.

create cluster 1

GridGain Nebula default configuration offers a small 2-node cluster with 4 CPU, 30.5 GB RAM, and 400 GB of disk space. If this is sufficient for your needs, you only need to configure your starting user.

Applications that connect to the cluster must provide user credentials. Configure the credentials of the initial user that will be created during provisioning and keep them on hand.

You can create additional users in the Cluster management screen (or in the My cluster screen) after the cluster had been provisioned.

After you have configured user credentials, click Create cluster to finish configuration, or go over additional cluster parameters described below.

Select Cluster Size and Location

create cluster 2

  1. Click Edit in the Cluster nodes section.

    The Edit cluster nodes dialog opens.

    create cluster 8

  2. Select the cloud provider and region. For latency purposes, we recommend selecting a region that is closest to your customers. Regions in different parts of the world can lead to high latency.

  3. Optionally, select the Multiple availability zones option to improve the your cluster’s availability.

  4. Select the amount of data you plan to store in your Nebula cluster. The wizard will suggest the recommended configuration. Alternatively, click Select custom configuration to configure the number of instances manually.

    We recommend starting with two or three of small instances if you are testing the product.

    If you are not sure about the size or number instances you need for your environment, contact our support team to calculate the optimal configuration.

  5. Click Save.

Configure Data Regions

By default, you only have one data region with persistence enabled, but you can add more data regions that will use in-memory caches for improved performance.

Click Edit in the Data regions section to configure node data regions.

create cluster 3

In the above dialog, you can add any number of data regions with the following rules:

  • Total size of all data regions must be the same as your instance.

  • At least 1 GB must remain allocated to the default data region.

Optimal region sizes for production environment will depend on your data model. If you have doubts or questions, contact our support team.

When you have configured the data regions, click Continue.

Define Network Settings

You can define your cluster’s network settings as:

  • Public - the cluster is accessible over the Internet. You can protect it with a firewall that allows access only from specific IP addresses.

  • Private - the cluster is accessible only through AWS PrivateLink, from a Virtual Private Connection (VPC).

Public Networking

To define your cluster as public, click Edit in the Network Settings section, then select the Public option button in the Edit network settings dialog that opens.

create cluster 5

By default, the Allow access from any address check box is selected - this enables access to your cluster from any IP address, even if the real IP address is hidden from GridGain Nebula.

To restrict access to your cluster, clear the Allow access from any address check box and add the "whitelisted" IP addresses in the CIDR field. Click Add address for each additional CIDR.

create cluster 6

Private Networking

Make sure you have a valid AWS account.

Click Edit in the Network Settings section, then select the Private option button in the Edit network settings dialog that opens.

create cluster 7

In the Account ID field, add IDs of the accounts to connect to your cluster’s VPC via PrivateLink. Click Add account for each additional account (up to 3). Click Save when done.

After you have provisioned your cluster, run the following command in AWS CLI (replace the placeholders with your values):

aws ec2 create-vpc-endpoint --vpc-id {VPC-ID} \
--region {REGION} --service-name {SERVICE-NAME} \
--vpc-endpoint-type Interface --subnet-ids {SUBNET-IDS}

The placeholders are as follows.

Placeholder Description

{VPC-ID}

A unique string that identifies the peer AWS VPC. Find this value on the VPC dashboard in your AWS account.

{REGION}

An AWS region in which your database deployment resides.

{SUBNET-IDS}

A unique string that identifies the subnets that your AWS VPC uses. Find these values on the Subnet dashboard in your AWS account. You must specify at least one subnet. If you don’t, AWS won’t provision an interface endpoint in your VPC. An interface endpoint is required for clients in your VPC to send traffic to the private endpoint.

{SERVICE-NAME}

A unique string identifying the private endpoint service. Copy that string from the cluster details that appear in the GridGain Nebula UI after you have provisioned the cluster.

Define Data Encryption

In GridGain Nebula, your data is always encrypted:

  • In transit with the use of SSL/TLS

  • At rest at the volume level (the EBS volumes on AWS are encrypted)

However, for real-life, industry standard-compliant cluster operations, we recommend that you encrypt your data at the database level.

GridGain Nebula supports transparent database-level encryption that follows the envelope strategy. The key-encrypting key (a.k.a. the "main" key) is a Customer Managed Key (CMK). You fully control the CMK; GridGain Nebula cannot access this key’s cryptographic data. The CMK GridGain Nebula uses on AWS is provided by the AWS Key Management Service (KMS).

To define transparent data encryption in your cluster:

  1. Make sure you have a valid AWS account.

  2. Under your AWS account, create a CMK (Customer Managed Key). The key must be symmetric, multi-regional, without auto-rotation.

    In the AWS CLI, run the following command:

    aws kms create-key \
        --tags TagKey=Purpose,TagValue=GridGain \
        --description "GridGain CMK" \
        --key-spec SYMMETRIC_DEFAULT \
        --key-usage ENCRYPT_DECRYPT \
        --multi-region \
        --region us-west-2
  3. Save the key ARN that appears in the command output.

  4. In the GridGain Nebula UI, in the Edit data encryption dialog, select Enabled.

    encryption 2

  5. Create a role for GridGain Nebula in your AWS account and a policy that enables the GridGain AWS account to assume the role you have created:

    1. Copy the JSON content that appears in the top field.

    2. On your machine, create the assume.json file and paste the copied content into that file.

    3. Upload the assume.json file to your AWS account using the Upload file option from the Actions pulldown menu in the AWS CLI window.

    4. Create the gridgain-kms-role AWS IAM role for accessing CMK (describe, encrypt, and decrypt) by running the following command in the AWS CLI:

      aws iam create-role \
       --role-name gridgain-kms-role \
       --assume-role-policy-document file://assume.json
    5. Save the role ARN that appears in the command output.

  6. In the Edit data encryption dialog, paste the role ARN into the IAM role ARN field. Click Continue.

  7. Paste the key ARN into the Customer Managed Key ARN field that opens.

    encryption 3

  8. Click Continue.

    encryption 4

  9. Update the previously created GridGain role with a policy that enables the GridGain AWS account to access the CMK for the managed cluster in your AWS account:

    1. Copy the JSON content that appears in field 1 under the Update policy section.

    2. On your machine, create the access.json file and paste the copied content into that file.

    3. Upload the access.json file to your AWS account using the Upload File option from the Actions pulldown menu in the AWS CLI window.

    4. Update the previously created gridgain-kms-role AWS IAM role by running the following command in the AWS CLI:

      aws iam put-role-policy \
       --role-name gridgain-kms-role \
       --policy-name gridgain-access-kms-role-policy \
       --policy-document file://access.json
  10. In the Edit data encryption dialog, click Save.

Connect to Cluster

Once you click Create cluster, GridGain Nebula starts provisioning the cluster you have requested. When it is available, you can connect a sample SQL application or connect a sample Java application.