Tair (Redis® OSS-Compatible):Use the Sentinel-compatible mode to connect to an instance

In this example, Spring Data Redis 2.4.2 is used.

    @Bean
    public JedisConnectionFactory connectionFactory() {
        RedisSentinelConfiguration sentinelConfig = new RedisSentinelConfiguration()
                .master("testmaster")
                .sentinel("r-bp10noxlhcoim2****.redis.rds.aliyuncs.com", 6379);
        JedisPoolConfig poolConfig = new JedisPoolConfig();
        ...
        JedisConnectionFactory connectionFactory = new JedisConnectionFactory(sentinelConfig, poolConfig);
        return connectionFactory;
    }

Parameters:

• master: the name of the master. You can use the default value, such as testmaster.

• sentinel: the VPC endpoint and port number of the instance. Separate the endpoint and port number with a comma (,). Example: "r-bp10noxlhcoim2****.redis.rds.aliyuncs.com", 6379.

In this example, Python 3.9 and redis-py 4.3.6 are used.

from redis.sentinel import Sentinel
SENTINEL_HOST = "r-bp10noxlhcoim2****.redis.rds.aliyuncs.com"
SENTINEL_PORT = 6379
SENTINEL_MASTER_NAME = "testmaster"

sentinel = Sentinel([(SENTINEL_HOST, SENTINEL_PORT)])
r = sentinel.master_for(SENTINEL_MASTER_NAME, db=0)
r.set('foo', 'bar')
print(r.get('foo'))

Parameters:

• SENTINEL_HOST and SENTINEL_PORT: the VPC endpoint and port number of the instance.

• SENTINEL_MASTER_NAME: the name of the master. You can use the default value, such as testmaster.

In this example, a Java client of the earliest version is used. The clients must meet the following requirements:

• Jedis 3.6.0 or later is used.

• Lettuce 5.3.0.RELEASE or later is used.

• Spring Data Redis 2.5.1 or later is used. The spring.redis.sentinel.password parameter is specified for the Spring Data Redis client.

        String masterName = "any-name";
        Set<String> sentinels = new HashSet<>();
        sentinels.add("r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379");
        GenericObjectPoolConfig poolConfig = new GenericObjectPoolConfig();
        String dbPassword = "testaccount:Rp829dlwa";
        String sentinelPassword = "testaccount:Rp829dlwa";

        JedisSentinelPool jedisSentinelPool =
                new JedisSentinelPool(masterName, sentinels, poolConfig,
                        2000, 2000, dbPassword,
                        0, null, 2000, 2000,
                        sentinelPassword, null);

The following table describes the parameters used in the syntax.

• masterName: the name of the master. You can use the default value, such as testmaster.

• sentinels.add: the VPC endpoint and port number of the instance. Example: r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379.

• dbPassword and sentinelPassword: the account password of the instance. The password format varies based on the account that you select. If you forget your password, you can reset it. For more information, see Change or reset the password.

  Note

  • If you use the default account whose username is the same as the instance ID, directly enter the password.

  • If you use a custom account, enter the password in the <user>:<password> format. A password in this format can also be used for default account logon. For example, if the username of a custom account is testaccount and the password is Rp829dlwa, enter testaccount:Rp829dlwa as the password.

In this example, Python 3.9 and redis-py 4.3.6 are used.

from redis.sentinel import Sentinel
SENTINEL_HOST = "r-bp10noxlhcoim2****.rds.aliyuncs.com"
SENTINEL_PORT = 6379
SENTINEL_MASTER_NAME = "redis_master"  # Note: This name cannot be changed.
SENTINEL_REDIS_PWD = "testaccount:Rp829dlwa"

conf = {
    'password': SENTINEL_REDIS_PWD,
}

sentinel = Sentinel([(SENTINEL_HOST, SENTINEL_PORT)], sentinel_kwargs=conf)
r = sentinel.master_for(SENTINEL_MASTER_NAME, db=0, **conf)
r.set('foo', 'bar')
print(r.get('foo'))

Parameters:

• SENTINEL_HOST and SENTINEL_PORT: the VPC endpoint and port number of the instance.

• SENTINEL_MASTER_NAME: the name of the master in the Redis Sentinel configuration. The name is set to redis_master and cannot be changed.

• SENTINEL_REDIS_PWD: the account password of the instance.