Deploy ScyllaDB to Your Own Cloud Account - GCP¶

Prerequisites¶

Verify that the recommended limits are set for your GCP account.

• GCP Account Limits

• GCP Role Permissions

Linking Your GCP Account with ScyllaDB Cloud¶

Before you provision a cluster in your GCP account, you must link that account with ScyllaDB Cloud.

To make linking easier, we will provide you with a terraform template. You will need terraform and GCP permissions to grant all required permissions.

A wizard will guide you through the process.

1. Go to Managed Resources via the drop-down in the top right corner next to your username.

2. Open the Bring Your Own Account tab.

3. Click Add Account to open the Add Cloud Account wizard.

4. Choose your Google Cloud Platform from the Provider drop-down.

5. In the Project ID field, specify your project ID.

   You can copy your project ID from the Google Cloud Console.

   

6. Click Generate Template to generate a Terraform template that includes all files required for provisioning the cloud resources.

7. Click Next to open a screen displaying further instructions and the Cloud Resource Template Secret that will be required while applying the Terraform template.

   

8. Click Download template to download the Terraform template (a ZIP archive).

9. Unzip the archive.

10. In a terminal, navigate to the unzipped directory and run the following terraform commands to set up the account.

    • To initialize Terraform:

      terraform init
      

    • To dry run:

      terraform plan
      

    • To apply the changes:

      terraform apply
      

    When running terraform init and terraform plan, you will be prompted to enter the Cloud Resource Template Secret:

    

    Copy and paste the Cloud Resource Template Secret from the wizard:

    

11. Go back to the wizard and click Verify to verify that your GCP account has been set up correctly.

12. (Optional) While waiting for verification to complete, you can add a custom alias for your account. A user-friendly identifier is helpful if your ScyllaDB account is connected to multiple AWS accounts to clearly identify and manage each account.

Once Terraform completes successfully and verification is confirmed, your GCP account is ready to be used for the deployment of ScyllaDB clusters. When you select the Your GCP Account option during cluster creation, the new account will be available in the drop-down (either the alias, if provided, or the Project name will be displayed).

To add another GCP account, repeat the steps above. You can link multiple GCP accounts to one ScyllaDB Cloud account.

Reviewing and Managing Your Accounts¶

To review the list of your accounts linked with ScyllaDB Cloud, go to Managed Resources via the drop-down and open the Bring Your Own Account tab.

It will display the following information:

• Alias - A user-friendly name for your account that simplifies referencing and management. To add or update an alias, click the Actions menu for the account and choose Edit Alias.

• Account/Project - The name of your AWS account or GCP Project.

• ID - The ID of your account in ScyllaDB Cloud (byoa_id). It is required to create a cluster using ScyllaDB Cloud API or Terraform.

• Provider - Your cloud provider name.

• Date Added - The date when the account was added to ScyllaDB Cloud.

• Status - The status of the account in ScyllaDB Cloud:

  • Available - The account is added to ScyllaDB Cloud and verified. You can use it when creating a new cluster.

  • Pending Action - The account has not been provisioned. You can click Resume to finalize your account.

  • In Use - The account is in use by an existing cluster. You can click the Cluster Name link next to the status to view the information about the cluster.

  • Deleted - The account has been deleted and cannot be re-used.

• Clusters - The list of clusters deployed under this account.

• Actions - An actions menu for managing the account. It includes options to delete the account or create an alias for it.

GCP Account Limits¶

To ensure that you don’t exceed your GCP account quota, we suggest setting a specific quota for the resources that ScyllaDB Cloud will use. Please note that the recommended limits should be considered in addition to your current resource allocation.

GCP BYOA Role Permissions¶

This section lists the permissions that ScyllaDB Cloud role requires to deploy and manage your clusters in your GCP account.