This guide takes you step-by-step through how to get your ScyllaDB Cloud cluster up and running quickly.
Before you start, here’s a short introduction video to ScyllaDB Cloud’s capabilities and UI.
Go to cloud.scylladb.com and log in to your account, or sign up to create a new user account.
Go to New Cluster, or click Free Trial if you are a new user.
Configure your cluster parameters:
Specify AWS as your cloud provider. The ScyllaDB Cloud wizard will automatically update the list of geographic regions where you can deploy your cluster and instance types, providing the estimated cost of cloud compute resources per hour per nod.
Specify where you want your ScyllaDB Cloud AWS resources to be deployed. You can choose:
Scylla AWS account.
Your AWS account. This option allows you to deploy ScyllaDB Cloud resources directly into servers from your own AWS accounts. We call it Bring Your Own Account or BYOA. If you choose this option, a wizard will walk you through all the steps to create a cloud policy and an IAM role for ScyllaDB Cloud. See Deploy Scylla Cloud - Bring Your Own Account for more information.
Specify the cluster name.
Whitelist IP addresses that will be able to communicate with your cluster on ScyllaDB Cloud to ensure the security of your data.
Configure your deployment by selecting instance types within your desired geographic region, the number of nodes you need, and the replication factor you want for your data. ScyllaDB Cloud will automatically provision your cluster across multiple availability zones to ensure your cluster’s high availability. You can use our capacity planning calculator to help you properly size your cluster.
(Recommended) Enable the Enable VPC Peering option to avoid routing your traffic over the open internet and ensure that your cluster and the application layer connect via a private network. Enabling this option will allow you to set up VPC peering after you launch the cluster.
You must enable this option when creating your cluster to be able to configure VPC peering. VPC peering cannot be enabled for an existing cluster.
Click Launch Cluster. It will take a few minutes for your cluster to launch.
If you enabled the VPC peering when configuring your cluster, now VPC peering needs to be configured. The wizard will guide you through the configuration process. See AWS Virtual Private Network (VPC) Peering Setup Guide for details about configuring VPC peering on AWS.
When your cluster is launched, you can immediately connect to it. ScyllaDB Cloud provides you with default credentials and detailed instructions on how to connect to your cluster with different clients and drivers.
Go to My Clusters and open your cluster’s view.
Open the Connect tab. The tab displays the information about your cluster, such as the name of its data center and the default credentials for password authentication.
Run the following command to change the default password of the scylla user:
# replacing 'new_password' with a secure password. ALTER ROLE scylla WITH PASSWORD = 'new_password';
Choose how you want to connect with your cluster. The Connect tab includes links to the instructions on how to connect using CQL shell command (Cqlsh) or Scylla CQL drivers. For example, to connect with Cqlsh on docker, run:
docker run -it --rm --entrypoint cqlsh scylladb/scylla -u [USERNAME] -p [PASSWORD] [NODE IP]
Your username, password, and node IP addresses are displayed on your cluster’s information page.
Example:docker run -it --rm --entrypoint cqlsh scylladb/scylla -u scylla -p gZ47gglKjd 126.96.36.199
You’re all set. Now you can define your keyspace, create tables, and insert values. See Using ScyllaDB to learn how to work with ScyllaDB.
Check out the following resources for hands-on experience with ScyllaDB Cloud:
Getting Started With Scylla Cloud Lab on Scylla University - Learn step-by-step how to create a cluster, connect to it, and execute basic commands to insert and select sample data.
Getting Started with Scylla Cloud project on GitHub - Build a simple CRUD application and connect it to ScyllaDB Cloud.