全部產品
Search
文件中心

Tair:使用Sentinel相容模式串連Tair

更新時間:Jul 31, 2024

雲原生記憶體資料庫Tair採用自研的高可用服務HA組件,無需依賴Sentinel(哨兵)。但為了提高雲原生記憶體資料庫Tair的相容性,減少代碼改動,雲原生記憶體資料庫Tair提供Sentinel相容模式,開啟後用戶端可以像串連開源Redis Sentinel一樣串連Tair執行個體。

Redis Sentinel簡介

Redis Sentinel為開源Redis提供主從執行個體監控、故障警示、自動故障切換等服務,很多使用本地自建Redis資料庫並且對可靠性要求較高的業務情境都用到了Sentinel。為了給這類情境中的Redis資料庫遷移上雲提供方便,阿里雲開發了Sentinel相容模式。開啟Sentinel相容模式後,您可以使用如下的Sentinel相關命令:

命令

說明

SENTINEL sentinels

查詢master的Sentinel執行個體列表以及這些Sentinel執行個體的狀態。使用方式:

SENTINEL sentinels <任意名稱>

SENTINEL get-master-addr-by-name

查詢master的IP地址和連接埠號碼。使用方式:

SENTINEL get-master-addr-by-name <任意名稱>

關於Sentinel相關命令在各版本中的支援度,請參見Tair命令支援與限制

前提條件

已將用戶端的IP地址(ECS執行個體的內網IP地址或本地主機的外網IP地址)加入Tair白名單

操作步驟

  1. 訪問Tair執行個體列表,在上方選擇地區,然後單擊目標執行個體ID。

  2. 執行個體資訊頁的左側導覽列中,單擊參數設定

  3. 根據執行個體架構,通過修改對應的參數開啟Sentinel相容模式,具體操作請參見設定執行個體參數

    • 若執行個體為叢集架構代理模式或讀寫分離架構:將sentinel_compat_enable參數的值修改為1

    • 若執行個體為標準架構:將#no_loose_sentinel-enabled參數的值修改為yes

    說明
    • 您可以在執行個體詳情頁確認執行個體的架構資訊。

    • 叢集架構直連模式使用開源Redis Cluster進行負載平衡,無需Sentinel組件,也不支援設定Sentinel參數。

    開啟後,您可以串連執行個體,執行SENTINEL sentinels test命令進行測試,執行成功表示執行個體已開啟Redis Sentinel相容模式。Sentinel相容模式不提供額外的串連地址,您可以直接通過原串連地址(例如r-********.redis.rds.aliyuncs.com:6379)進行串連。

Sentinel串連樣本

開啟Sentinel相容模式後,有兩種方式串連Tair執行個體:若執行個體開啟專用網路免密訪問,您可以通過Sentinel模式免密串連Tair執行個體;若未開啟免密訪問,您需要在串連時配置驗證資訊。

Sentinel免密串連

說明

開啟專用網路免密訪問的具體操作,請參見開啟專用網路免密訪問

阿里雲Tair Sentinel相容模式串連代碼配置樣本如下。

Spring Data Redis

本樣本的Spring Data Redis版本為2.4.2。

    @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;
    }

參數說明:

  • master:自訂名稱,可保持預設,例如testmaster

  • sentinelTair執行個體的專用網路串連地址與連接埠號碼,用英文逗號(,)分隔,例如"r-bp10noxlhcoim2****.redis.rds.aliyuncs.com", 6379

redis-py

本樣本的Python版本為3.9、redis-py版本為4.3.6。

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'))

參數說明:

  • SENTINEL_HOSTSENTINEL_PORTTair執行個體的專用網路串連地址與連接埠號碼。

  • SENTINEL_MASTER_NAME:自訂名稱,可保持預設,例如testmaster

Sentinel密碼串連

阿里雲Tair Sentinel相容模式串連代碼配置樣本如下

Java

本樣本以Java用戶端的最低版本為例,用戶端版本要求如下:

  • Jedis為3.6.0版本及以上。

  • Lettuce為5.3.0.RELEASE版本及以上。

  • Spring Data Redis為2.5.1版本及以上,同時需要配置spring.redis.sentinel.password參數。

說明

強烈建議您升級最新穩定版本用戶端,最新版本請搜尋MVN Repository

        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);

參數說明:

  • masterName:自訂名稱,可保持預設,例如testmaster

  • sentinels.add:設定為Tair執行個體的專用網路串連地址和連接埠號碼,格式為r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379

  • dbPasswordsentinelPassword:設定為Tair執行個體帳號的密碼。根據選取帳號的不同,密碼的填寫格式有一定區別。如果忘記密碼,您可以重設密碼。具體操作,請參見修改或重設密碼

    說明
    • 預設帳號(即以執行個體ID命名的帳號):直接填寫密碼即可。

    • 新建立的帳號:密碼格式為<user>:<password>,預設帳號也支援此認證方式。例如自訂帳號為testaccount,密碼為Rp829dlwa,密碼需填寫為testaccount:Rp829dlwa

redis-py

本樣本的Python版本為3.9、redis-py版本為4.3.6。

from redis.sentinel import Sentinel
SENTINEL_HOST = "r-bp10noxlhcoim2****.rds.aliyuncs.com"
SENTINEL_PORT = 6379
SENTINEL_MASTER_NAME = "redis_master"  # 注意:此名稱不可更改
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'))

參數說明:

  • SENTINEL_HOSTSENTINEL_PORTTair執行個體的專用網路串連地址與連接埠號碼。

  • SENTINEL_MASTER_NAME:SENTINEL名稱,此名稱不可更改,固定為redis_master

  • SENTINEL_REDIS_PWD:Tair執行個體帳號的密碼。

常見問題

  • Q:原來使用自建Redis Sentinel模式,切換至Tair Sentinel後,遇到NOAUTH Authentication required錯誤該怎麼處理?

    A:您可以啟用#no_loose_sentinel-password-free-access參數(設定為yes),即可在不開啟VPC免密功能的情況下,在VPC串連地址中實現Sentinel免密串連。

    若執行個體為Redis 6.0以下,請升級您的用戶端,並修改部分代碼用以添加Sentinel認證密碼,再進行重試。更多資訊,請參見本文中的Sentinel密碼串連