ApsaraDB for Redis:Use a private endpoint to connect to an ApsaraDB for Redis instance

In this example, Jedis 4.3.0 is used. For more information, visit GitHub.

• Custom connection pool (recommended)

  import redis.clients.jedis.*;
  import java.util.HashSet;
  import java.util.Set;
  
  public class DirectTest {
      private static final int DEFAULT_TIMEOUT = 2000;
      private static final int DEFAULT_REDIRECTIONS = 5;
      private static final ConnectionPoolConfig config = new ConnectionPoolConfig();
  
      public static void main(String args[]) {
          // Specify the maximum number of idle connections. In direct connection mode, the client directly connects to a shard of a cluster instance. Therefore, the following requirement must be met: Number of clients × Value of MaxTotal < Maximum number of connections to a single shard. 
          // Set the maximum number of connections to a shard of an ApsaraDB for Redis Community Edition instance to 10000 and set the maximum number of connections to a shard of a Tair instance to 30000. 
          config.setMaxTotal(30);
          // Specify the maximum number of idle connections based on your business needs. 
          config.setMaxIdle(20);
          config.setMinIdle(15);
  
          // Specify the private endpoint that is allocated to the cluster instance. 
          String host = "r-bp1xxxxxxxxxxxx.redis.rds.aliyuncs.com";
          int port = 6379;
          // Specify the password that is used to connect to the cluster instance. 
          String password = "xxxxx";
  
          Set<HostAndPort> jedisClusterNode = new HashSet<HostAndPort>();
          jedisClusterNode.add(new HostAndPort(host, port));
          JedisCluster jc = new JedisCluster(jedisClusterNode, DEFAULT_TIMEOUT, DEFAULT_TIMEOUT, DEFAULT_REDIRECTIONS,
              password, "clientName", config);
  
          jc.set("key", "value");
          jc.get("key");
  
          jc.close();     // If the application exits and you want to destroy the resources, call this method. Then, the connection is closed, and the resources are released. 
      }
  }

• Default connection pool

  import redis.clients.jedis.ConnectionPoolConfig;
  import redis.clients.jedis.HostAndPort;
  import redis.clients.jedis.JedisCluster;
  import java.util.HashSet;
  import java.util.Set;
  
  public class DirectTest{
      private static final int DEFAULT_TIMEOUT = 2000;
      private static final int DEFAULT_REDIRECTIONS = 5;
      private static final ConnectionPoolConfig DEFAULT_CONFIG = new ConnectionPoolConfig();
  
      public static void main(String args[]){
  
          // Specify the private endpoint that is allocated to the cluster instance. 
          String host = "r-bp1xxxxxxxxxxxx.redis.rds.aliyuncs.com";
          int port = 6379;
          String password = "xxxx";
  
          Set<HostAndPort>  jedisClusterNode = new HashSet<HostAndPort>();
          jedisClusterNode.add(new HostAndPort(host, port));
  
          JedisCluster jc = new JedisCluster(jedisClusterNode, DEFAULT_TIMEOUT, DEFAULT_TIMEOUT,
              DEFAULT_REDIRECTIONS,password, "clientName", DEFAULT_CONFIG);
  
          jc.set("key","value");
          jc.get("key");
  
          jc.close();     // If the application exits and you want to destroy the resources, call this method. Then, the connection is closed, and the resources are released. 
      }
  }

In this example, PhpRedis 5.3.7 is used. For more information, visit GitHub.

<?php
 // Specify the private endpoint and the port number that are used to connect to the cluster instance. 
 $array = ['r-bp1xxxxxxxxxxxx.redis.rds.aliyuncs.com:6379'];
 // Specify the password that is used to connect to the cluster instance. 
 $pwd = "xxxx";
 
 // Use the password to connect to the cluster instance. 
 $obj_cluster = new RedisCluster(NULL, $array, 1.5, 1.5, true, $pwd);
 
 // Display the result of the connection. 
 var_dump($obj_cluster);
 
 if ($obj_cluster->set("foo", "bar") == false) {
     die($obj_cluster->getLastError());
 }
 $value = $obj_cluster->get("foo");
 echo $value;
 ?>

In this example, Python 3.9 and redis-py 4.4.1 are used. For more information, visit GitHub.

# !/usr/bin/env python
# -*- coding: utf-8 -*-
from redis.cluster import RedisCluster
# Replace the values of the host and port parameters with the endpoint and port number that are used to connect to the Tair instance. 
host = 'r-bp10noxlhcoim2****.redis.rds.aliyuncs.com'
port = 6379
# Replace the values of the user and pwd parameters with the username and password that are used to connect to the Tair instance. 
user = 'testaccount'
pwd = 'Rp829dlwa'
rc = RedisCluster(host=host, port=port, username=user, password=pwd)
# You can perform operations on the instance after the connection is established. For example, you can run the following code to call the SET and GET methods. 
rc.set('foo', 'bar')
print(rc.get('foo'))

In this example, Spring Data Redis 2.7.6 is used. For more information, visit GitHub.

• Spring Data Redis with Jedis (recommended)

  @Bean
       JedisConnectionFactory redisConnectionFactory() {
           List<String> clusterNodes = Arrays.asList("host1:port1", "host2:port2", "host3:port3");
           RedisClusterConfiguration redisClusterConfiguration = new RedisClusterConfiguration(clusterNodes);
           redisClusterConfiguration.setPassword("xxx");
   
           JedisPoolConfig jedisPoolConfig = new JedisPoolConfig();
           // Specify the maximum number of idle connections. In direct connection mode, the client directly connects to a shard of a cluster instance. Therefore, the following requirement must be met: Number of clients × Value of MaxTotal < Maximum number of connections to a single shard. 
           // Set the maximum number of connections to a shard of an ApsaraDB for Redis Community Edition instance to 10000 and set the maximum number of connections to a shard of a Tair instance to 30000. 
           jedisPoolConfig.setMaxTotal(30);
           // Specify the maximum number of idle connections based on your business needs. 
           jedisPoolConfig.setMaxIdle(20);
           // Disable testOn[Borrow|Return] to prevent generating additional ping commands.
           jedisPoolConfig.setTestOnBorrow(false);
           jedisPoolConfig.setTestOnReturn(false);
   
           return new JedisConnectionFactory(redisClusterConfiguration, jedisPoolConfig);
       }

• Spring Data Redis with Lettuce

  Bean
       public LettuceConnectionFactory redisConnectionFactory() {
           List<String> clusterNodes = Arrays.asList("host1:port1", "host2:port2", "host3:port3");
           RedisClusterConfiguration redisClusterConfiguration = new RedisClusterConfiguration(clusterNodes);
           redisClusterConfiguration.setPassword("xxx");
   
           ClusterTopologyRefreshOptions topologyRefreshOptions = ClusterTopologyRefreshOptions.builder()
               .enablePeriodicRefresh(Duration.ofSeconds(15))
               .dynamicRefreshSources(false)                            
               .enableAllAdaptiveRefreshTriggers()
               .adaptiveRefreshTriggersTimeout(Duration.ofSeconds(15)).build();
   
           LettuceClientConfiguration lettuceClientConfiguration = LettuceClientConfiguration.builder().
               clientOptions(ClusterClientOptions.builder()
                   .validateClusterNodeMembership(false)
                   .topologyRefreshOptions(topologyRefreshOptions).build()).build();
   
           return new LettuceConnectionFactory(redisClusterConfiguration, lettuceClientConfiguration);
       }

  The following table describes the parameters of ClusterTopologyRefreshOptions.builder.

  Parameter	Description	Example (recommended value)
  enablePeriodicRefresh(Duration refreshPeriod)	The interval at which the topology of the cluster instance is refreshed. We recommend that you set the interval to 15 seconds. If you set the interval to a smaller value, a large number of calls are made to the nodes of the cluster instance. This compromises the performance of the cluster instance.	15s
  dynamicRefreshSources()	Specifies whether to use the nodes whose IP addresses are obtained from the topology as nodes to be called to refresh the topology of the cluster instance. If you connect to an instance of ApsaraDB for Redis, you must set the parameter to false. Typically, ApsaraDB for Redis instances use VIPs. If you migrate an instance across zones, the VIPs of the instance are all changed. In this case, the route cannot be refreshed. If you set the parameter to false, the system uses a domain name that Alibaba Cloud provides to query the nodes of the cluster instance. The domain name service automatically performs load balancing and sends your request to the nodes of the ApsaraDB for Redis instance.	false
  enableAllAdaptiveRefreshTriggers()	Specifies whether to enable all triggers to adaptively refresh the topology. After adaptive refresh is enabled, the topology of the cluster instance is automatically refreshed each time a runtime event such as a MOVED redirection occurs on the cluster instance.	No configuration is required.
  adaptiveRefreshTriggersTimeout(Duration timeout)	The time period during which the topology of the cluster instance can be refreshed only once. This prevents the topology from being frequently refreshed.	15s
  validateClusterNodeMembership()	Specifies whether to validate the membership of cluster nodes. The validation is not required for Alibaba Cloud ApsaraDB for Redis instances.	false

  For more information, see Class ClusterTopologyRefreshOptions.Builder.

In this example, .NET 6.0 and StackExchange.Redis 2.6.90 are used.

using StackExchange.Redis;

class RedisConnSingleton {
    // Specify the endpoint, port number, username, and password that are used to connect to the cluster instance. 
    //private static ConfigurationOptions configurationOptions = ConfigurationOptions.Parse("r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379,user=testaccount,password=Rp829dlwa,connectTimeout=2000");
    //the lock for singleton
    private static readonly object Locker = new object();
    //singleton
    private static ConnectionMultiplexer redisConn;
    //singleton
    public static ConnectionMultiplexer getRedisConn()
    {
        if (redisConn == null)
        {
            lock (Locker)
            {
                if (redisConn == null || !redisConn.IsConnected)
                {
                    redisConn = ConnectionMultiplexer.Connect(configurationOptions);
                }
            }
        }
        return redisConn;
    }
}

class Program
{
    static void Main(string[] args)
    {
        ConnectionMultiplexer cm = RedisConnSingleton.getRedisConn();
        var db = cm.GetDatabase();
        db.StringSet("key", "value");
        String ret = db.StringGet("key");
        Console.WriteLine("get key: " + ret);
    }
}

In this example, Node.js 19.4.0 and node-redis 4.5.1 are used.

import { createCluster } from 'redis';

// Specify the endpoint, port number, username, and password that are used to connect to the cluster instance. 
// After you supply the username and password for the url parameter, you must also supply the global username and password for the defaults parameter. 
// The global username and password are used to authenticate the remaining nodes. Otherwise, the NOAUTH error occurs. 

const cluster = createCluster({
    rootNodes: [{
        url: 'redis://testaccount:Rp829dlwa@r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379'
    }],
    defaults: {
        username: 'testaccount',
        password: 'Rp829dlwa'
    }
});

cluster.on('error', (err) => console.log('Redis Cluster Error', err));

await cluster.connect();

await cluster.set('key', 'value');
const value = await cluster.get('key');
console.log('get key: %s', value);

await cluster.disconnect();

In this example, Go 1.18.5 and go-redis 8.11.5 are used.

In this example, Lettuce 6.2.2 is used.

public class ClusterDemo {
     public static void main(String[] args) throws Exception {
         String host = "r-bp1xxxxxxxxxxxx.redis.rds.aliyuncs.com";
         int port = 30001;
         String password = "xxxx";
 
         RedisURI redisURI = RedisURI.Builder.redis(host)
             .withPort(port)
             .withPassword(password)
             .build();
 
         ClusterTopologyRefreshOptions refreshOptions = ClusterTopologyRefreshOptions.builder()
             .enablePeriodicRefresh(Duration.ofSeconds(15)) 
             .dynamicRefreshSources(false)
             .enableAllAdaptiveRefreshTriggers()
             .adaptiveRefreshTriggersTimeout(Duration.ofSeconds(15)).build();
 
         RedisClusterClient redisClient = RedisClusterClient.create(redisURI);
         redisClient.setOptions(ClusterClientOptions.builder()
             .socketOptions(SocketOptions.builder()
                 // Set the keepAlive parameter to true. 
                 .keepAlive(true) 
                 .build())
             .validateClusterNodeMembership(false)
             .topologyRefreshOptions(refreshOptions).build());
 
         StatefulRedisClusterConnection<String, String> connection = redisClient.connect();
         connection.sync().set("key", "value");
     }
 }

For information about the parameters of ClusterTopologyRefreshOptions.builder, see the description in the preceding Spring Data Redis with Jedis (recommended) section.