Sentinel/sentinel-extension/sentinel-datasource-redis
moon tiger 4ff2e37abb Add DataSource integration for Redis (#102)
- This implementation uses Lettuce as the internal client, and leverages Redis pub-sub feature to implement push mode data source. (by @tigerMoon)
2018-09-14 14:08:50 +08:00
..
src Add DataSource integration for Redis (#102) 2018-09-14 14:08:50 +08:00
README.md Add DataSource integration for Redis (#102) 2018-09-14 14:08:50 +08:00
pom.xml Add DataSource integration for Redis (#102) 2018-09-14 14:08:50 +08:00

README.md

Sentinel DataSource Redis

Sentinel DataSource Redis provides integration with Redis. make Redis as dynamic rule data source of Sentinel. The data source uses push model (listener) with redis pub/sub feature.

NOTE: we not support redis cluster as a pub/sub dataSource now.

To use Sentinel DataSource Redis, you should add the following dependency:

<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-datasource-redis</artifactId>
    <version>x.y.z</version>
</dependency>

Then you can create an RedisDataSource and register to rule managers. For instance:

ReadableDataSource<String, List<FlowRule>> redisDataSource = new RedisDataSource<List<FlowRule>>(redisConnectionConfig, ruleKey, channel, flowConfigParser);
FlowRuleManager.register2Property(redisDataSource.getProperty());

redisConnectionConfig : use RedisConnectionConfig class to build your connection config.

ruleKey : when the json rule data publish. it also should save to the key for init read.

channel : the channel to listen.

you can also create multi data source listen for different rule type.

you can see test cases for usage.

Before start

RedisDataSource init config by read from redis key ruleKey, value store the latest rule config data. so you should first config your redis ruleData in back end.

since update redis rule data. it should simultaneously send data to channel.

you may implement like this (using Redis transaction):


MULTI
PUBLISH channel value
SET ruleKey value
EXEC

How to build RedisConnectionConfig

Build with redis standLone mode

RedisConnectionConfig config = RedisConnectionConfig.builder()
                .withHost("localhost")
                .withPort(6379)
                .withPassword("pwd")
                .withDataBase(2)
                .build();

Build with redis sentinel mode

RedisConnectionConfig config = RedisConnectionConfig.builder()
                .withRedisSentinel("redisSentinelServer1",5000)
                .withRedisSentinel("redisSentinelServer2",5001)
                .withRedisSentinelMasterId("redisSentinelMasterId").build();