Create cluster

Create cluster

Cluster is an object composed of multiple nodes, and its state is automatically managed by the MemStore service. When a user creates or deletes a cluster, the service performs the operation and updates the state accordingly. A cluster consists of multiple nodes, each assigned as either a Primary or Replica.
The following describes how to create a new cluster in the MemStore service.

info

• The security group applied to the cluster must allow access on the port specified at the time of creation.
• For the t1i instance type, it may take several minutes to tens of minutes to transition to the Running state after initial creation.
  In addition, if the CPU credit balance is low, operations with CPU load may not function properly, so caution is advised.

caution

User authentication is not supported for Redis OSS engine version 5 or lower.

1. Go to the KakaoCloud Console > Data Store > MemStore.
2. In the Cluster menu, click the [Create cluster] button.

Create new cluster

Use cluster mode

1. In the configuration options, select Create new cluster and choose Enable for Cluster mode setting.
2. Enter the required information to create a cluster.

Category	Item	Description
Cluster mode setting		Select whether to enable cluster mode
Basic settings	Cluster name	Name of the cluster - Duplicate names are not allowed within the same project
	Description (optional)	Optional description of the cluster (up to 100 characters)
Redis compatibility	Engine version	Set the version of the Redis OSS engine to be used on the nodes
	Port	Port used to connect to Redis - Default is 6379 - Can specify a port between 2000 and 50000
User authentication		Enable or disable user authentication for MemStore resource access If disabled, default account is used. If enabled, access is via specified ID and password
User account settings	ID	Required when user authentication is enabled * Reserved usernames cannot be used
	Password	- Format: 8–16 characters
Transport encryption (TLS)		Whether to use encrypted connections If disabled, a plain connection is used. If enabled, TLS 1.2 is supported. The required ca.crt file can be downloaded from the cluster detail page after creation
Parameter group		Select a parameter group that matches the chosen engine version and cluster mode
Shard configuration	Number of shards	Enter the number of shards to be created - Must be an integer between 1 and 12
	Nodes per shard	Enter the number of nodes per shard - Must be an integer between 2 and 5
Node type		Choose a node type that offers sufficient memory for your service environment and performance needs - See Node types for details
Network settings	VPC	Select one of the pre-created user VPCs
	Subnet	Select from pre-created user subnets - Multiple selections allowed
	Security group	Create a new security group or select an existing one to apply to the cluster - Multiple selections allowed
Shard placement		Select the subnets where each node in a shard will be created
Automatic backup	Auto backup option	Whether to enable automatic daily backup - Available only when there are two or more nodes
	Backup retention period	Backup retention period, selectable from 1 to 35 days
	Auto backup start time	Time when automatic backup starts; backup begins within 15 minutes of the selected time

Create cluster without enabling cluster mode

1. In the configuration options, select Create new cluster and choose Disable for Cluster mode setting.

2. Enter the required information to create a cluster.

   Category	Item	Description
   Cluster mode setting		Select whether to enable cluster mode
   Basic settings	Cluster name	Name of the cluster - Duplicate names are not allowed within the same project
   	Description (optional)	Optional description of the cluster (up to 100 characters)
   Redis compatibility	Engine version	Set the version of the Redis OSS engine to be used on the nodes
   	Port	Port used to connect to Redis - Default is 6379 - Can specify a port between 2000 and 50000
   User authentication		Enable or disable user authentication for MemStore resource access If disabled, access is via default account. If enabled, use the specified ID and password * Not supported for Redis OSS engine version 5 or lower
   User account settings	ID	Required when user authentication is enabled - Reserved usernames cannot be used
   	Password	- Format: 8–16 characters - Korean characters, spaces, and special characters /, ', ", @ are not allowed
   Transport encryption (TLS)		Whether to use encrypted connections If disabled, a plain connection is used. If enabled, TLS 1.2 is supported. The required ca.crt file can be downloaded from the cluster detail page after creation * Not supported for Redis OSS engine version 5 or lower
   Parameter group		Select a parameter group that matches the chosen engine version and cluster mode
   Number of nodes	Number of nodes	Desired number of nodes - When using high availability: enter a value between 2 and 6 * 1 Primary node and 1–5 Replica nodes can be created - When not using high availability: enter a value between 1 and 6 * 1 Primary node and 0–5 Replica nodes can be created Example: To create 1 Primary and 2 Replicas, enter 3
   	High availability	Select whether to use high availability in case of node failure - If enabled, automatic failover and node replacement will maintain the node count
   Node type		Choose a node type that offers sufficient memory for your service environment and performance needs - See Node types for details
   Network settings	VPC	Select one of the pre-created user VPCs
   	Subnet	Select from pre-created user subnets
   	Security group	Create a new security group or select an existing one to apply to the cluster - Multiple selections allowed
   Node placement		Based on the selected network configuration, choose subnets for each role-based node
   Automatic backup	Auto backup option	Whether to enable automatic daily backup - Available only when there are two or more nodes
   	Backup retention period	Backup retention period, selectable from 1 to 35 days

Restore cluster

caution

• For MemStore service stability, restoration is only possible using the same or higher Redis engine version as the backup source.
• Restoration is only possible using the same cluster mode as the selected backup.
• If restoring from an existing MemStore backup, and the source backup cache size exceeds 60% of the memory of the target cluster flavor, restoration may fail.

1. In the configuration options, select Restore cluster.

2. To restore from an existing backup, choose Backup type > MemStore backup in the restore settings.

3. To restore from a file stored in Object Storage, choose Backup type > User backup file and enter the Object Storage path containing the backup file.

4. Enter the required information to create the cluster.

   When using cluster mode

   Category	Item	Description
   Restore source info		Information about the backup source file used for restore. A new cluster will be created using this data.
   Cluster mode setting		Select whether to enable cluster mode
   Basic settings	Cluster name	Name of the cluster - Duplicate names are not allowed within the same project
   	Description (optional)	Optional description of the cluster (up to 100 characters)
   Redis compatibility	Engine version	Set the version of the Redis OSS engine to be used on the nodes
   	Port	Port used to connect to Redis - Default: 6379 - Can specify a port between 2000 and 50000
   User authentication		Enable or disable user authentication for MemStore resource access If disabled, default account is used. If enabled, access is via specified ID and password
   User account settings	ID	Required when user authentication is enabled - Format: 1–32 characters, lowercase letters and _ only * Reserved usernames cannot be used
   	Password	- Format: 8–16 characters - Korean, spaces, and special characters /, ', ", @ are not allowed
   Transport encryption (TLS)		Whether to use encrypted connections If disabled, a plain connection is used. If enabled, TLS 1.2 is supported. The required ca.crt file can be downloaded from the cluster detail page after creation
   Parameter group		Select a parameter group that matches the chosen engine version and cluster mode
   Shard configuration	Number of shards	Number of shards to be created When restoring with cluster mode, the number of shards cannot be changed to ensure data integrity
   	Nodes per shard	Number of nodes per shard - Must be an integer between 2 and 5
   Node type		Choose a node type that offers sufficient memory for your service environment and performance needs - See Node types for details
   Network settings	VPC	Select one of the pre-created user VPCs
   	Subnet	Select from pre-created user subnets - Multiple selections allowed
   	Security group	Create a new security group or select an existing one to apply to the cluster - Multiple selections allowed
   Shard placement		Select the subnets where each node in a shard will be created
   Automatic backup	Auto backup option	Whether to enable automatic daily backup - Available only when there are two or more nodes
   	Backup retention period	Backup retention period, selectable from 1 to 35 days
   	Auto backup start time	Time when automatic backup starts; backup begins within 15 minutes of the selected time

   When not using cluster mode

   Category	Item	Description
   Restore source info		Information about the backup source file used for restore. A new cluster will be created using this data.
   Cluster mode setting		Select whether to enable cluster mode
   Basic settings	Cluster name	Name of the cluster - Duplicate names are not allowed within the same project
   	Description (optional)	Optional description of the cluster (up to 100 characters)
   Redis compatibility	Engine version	Set the version of the Redis OSS engine to be used on the nodes
   	Port	Port used to connect to Redis - Default: 6379 - Can specify a port between 2000 and 50000
   User authentication		Enable or disable user authentication for MemStore resource access If disabled, access is via default account. If enabled, use the specified ID and password * Not supported for Redis OSS engine version 5 or lower
   User account settings	ID	Required when user authentication is enabled - Format: 1–32 characters, lowercase letters and _ only * Reserved usernames cannot be used
   	Password	- Format: 8–16 characters - Korean, spaces, and special characters /, ', ", @ are not allowed
   Transport encryption (TLS)		Whether to use encrypted connections If disabled, a plain connection is used. If enabled, TLS 1.2 is supported. The required ca.crt file can be downloaded from the cluster detail page after creation * Not supported for Redis OSS engine version 5 or lower
   Parameter group		Select a parameter group that matches the chosen engine version and cluster mode
   Number of nodes	Node count	Desired number of nodes - When using high availability: enter a value between 2 and 6 * 1 Primary node and 1–5 Replica nodes can be created - When not using high availability: enter a value between 1 and 6 * 1 Primary node and 0–5 Replica nodes can be created Example: To create 1 Primary and 2 Replicas, enter 3
   	High availability	Select whether to use high availability in case of node failure - If enabled, automatic failover and node replacement will maintain the node count
   Node type		Choose a node type that offers sufficient memory for your service environment and performance needs - See Node types for details
   Network settings	VPC	Select one of the pre-created user VPCs
   	Subnet	Select from pre-created user subnets
   	Security group	Create a new security group or select an existing one to apply to the cluster - Multiple selections allowed
   Node placement		Select subnets where nodes for each role will be created based on the network configuration
   Automatic backup	Auto backup option	Whether to enable automatic daily backup
   	Backup retention period	Backup retention period, selectable from 1 to 35 days
   	Auto backup start time	Time when automatic backup starts; backup begins within 15 minutes of the selected time