Auto-Clustering

Redis Cluster

Redis Cluster is a distributed implementation of Redis, the open-source in-memory data structure store. It can be used for data storage, caching, message brokering, and similar workloads while providing high performance and high availability.

Redis Cluster Overview

The Redis Cluster package creates a topology with at least three Primary servers. Every Primary node is paired with a Secondary node to distribute read load and support automatic recovery when a Primary becomes unavailable.

Redis Cluster scheme
Redis Cluster uses Primary-Secondary node pairs for high performance and availability.

The cluster can be scaled manually or automatically. Every scaling operation adds or removes a pair of nodes: one Primary and one Secondary.

Redis Cluster Installation

Automatic installation and configuration are available through the Redis Auto-Clustering option in the topology wizard.

Redis auto-clustering
Enable Redis Auto-Clustering directly in the topology wizard.

Alternatively, import the Redis Cluster package manifest or install the package from Marketplace. The installation window provides the following parameters:

Nodes countSets the total number of Redis nodes. Scaling is performed in Primary-Secondary pairs. The documented minimum is 6 nodes (3 Primary + 3 Secondary) and maximum is 12 nodes (6 Primary + 6 Secondary).
Horizontal Auto-ScalingAdds scaling triggers and performs automatic resharding and rebalancing after adding and before removing a Primary node.
External IP AddressesAssigns a public IP to each cluster node and configures the cluster to work through public IP addresses only.
EnvironmentDefines the environment name.
Display NameSets the preferred environment alias.
RegionSelects the environment region when multiple regions are available.

Default Horizontal Auto-Scaling Conditions

  • Add 2 nodes when CPU or Memory load remains above 70% of total cluster capacity for more than 5 minutes, up to 12 total nodes.
  • Remove 2 nodes when CPU or Memory load remains below 40% of total cluster capacity for more than 15 minutes, while keeping at least 6 total nodes.
Redis Cluster auto scaling
Default Redis Cluster horizontal auto-scaling triggers.

After configuring the required settings, click Install.

Redis Cluster installation window
Configure the Redis Cluster installation parameters and start deployment.

When deployment finishes, the platform displays a success notification with Redis Cluster administration-panel credentials. The same access information is also sent by email.

Redis Cluster deployed
The success notification provides Redis Cluster access information.

Cluster Access and Verification

Once the cluster is deployed, open the administration panel to review cluster details and make the required configuration changes.

Redis Cluster admin panel
Use the Redis Cluster administration panel for cluster details and configuration.

You can also connect to any Redis cluster node through SSH, such as Web SSH, and use redis-cli to verify the cluster state.

redis-cli
auth {passw0rd}
cluster nodes

The cluster nodes output can be requested from any Primary or Secondary node. It shows the cluster node count, node IDs, addresses, roles, and the hash slots assigned to each node.

Redis Cluster SSH access
Verify Redis Cluster membership, node roles, addresses, and hash-slot allocation through redis-cli.

Expected Result

A Redis Cluster is deployed with at least three Primary-Secondary pairs. The cluster can be scaled in node pairs, optionally uses automatic horizontal scaling, and can be inspected through the administration panel or redis-cli.

Important Notes

  • The minimum documented topology is 6 nodes: 3 Primary and 3 Secondary.
  • The maximum documented topology is 12 nodes: 6 Primary and 6 Secondary.
  • Scaling always occurs in Primary-Secondary pairs.
  • Auto-scaling performs automatic resharding and rebalancing during node changes.
  • Enabling external IP addresses assigns a public IP to every cluster node and switches cluster communication to public IPs only.
  • Administration-panel credentials are shown after deployment and sent by email.

What’s Next?

  • Redis Overview
  • Create DB Server
  • Automatic Horizontal Scaling
  • SSH Access