文档 v2.7.0 版本已不再积极维护,你当前浏览的是一份归档快照。 最新文档请参阅 最新版本。
模块:REDIS
Redis是广受喜爱的开源高性能内存数据结构服务器,PostgreSQL的好伙伴。 配置 | 剧本 | 管理 | 监控 | 参数
概念
Redis的实体概念模型与PostgreSQL几乎相同,同样包括 集群(Cluster) 与 实例(Instance) 的概念。注意这里的Cluster指的不是Redis原生集群方案中的集群。
REDIS模块与PGSQL模块核心的区别在于,Redis通常采用 单机多实例 部署,而不是 PostgreSQL 的 1:1 部署:一个物理/虚拟机节点上通常会部署 多个 Redis实例,以充分利用多核CPU。因此配置和管理Redis实例的方式与PGSQL稍有不同。
在Pigsty管理的Redis中,节点完全隶属于集群,即目前尚不允许在一个节点上部署两个不同集群的Redis实例,但这并不影响您在在一个节点上部署多个独立 Redis 主从实例。当然这样也会有一些局限性,例如在这种情况下您就无法为同一个节点上的不同实例指定不同的密码了。
配置
身份参数
Redis 身份参数 是定义Redis集群时必须提供的信息,包括:
| 名称 | 属性 | 说明 | 例子 |
|---|---|---|---|
redis_cluster |
必选,集群级别 | 集群名 | redis-test |
redis_node |
必选,节点级别 | 节点号 | 1,2 |
redis_instances |
必选,节点级别 | 实例定义 | { 6001 : {} ,6002 : {}} |
redis_cluster:Redis集群名称,作为集群资源的顶层命名空间。redis_node:Redis节点标号,整数,在集群内唯一,用于区分不同节点。redis_instances:JSON对象,Key为实例端口号,Value为包含实例其他配置JSON对象。
工作模式
Redis有三种不同的工作模式,由 redis_mode 参数指定:
standalone:默认的独立主从模式cluster:Redis原生分布式集群模式sentinel:哨兵模式,可以为主从模式的 Redis 提供高可用能力
下面给出了三种Redis集群的定义样例:
- 一个1节点,一主一从的 Redis Standalone 集群:
redis-ms - 一个1节点,3实例的Redis Sentinel集群:
redis-sentinel - 一个2节点,6实例的的 Redis Cluster集群:
redis-cluster
局限性
- 一个节点只能属于一个 Redis 集群,这意味着您不能将一个节点同时分配给两个不同的Redis集群。
- 在每个 Redis 节点上,您需要为 Redis实例 分配唯一的端口号,避免端口冲突。
- 通常同一个 Reids 集群会使用同一个密码,但一个 Redis节点上的多个 Redis 实例无法设置不同的密码(因为 redis_exporter 只允许使用一个密码0
- Redis Cluster自带高可用,而Redis主从的高可用需要在 Sentinel 中额外进行手工配置:因为我们不知道您是否会部署 Sentinel。
- 好在配置 Redis 主从实例的高可用非常简单,可以通过Sentinel进行配置,详情请参考管理-设置Redis主从高可用
管理
下面是 REDIS 模块常用的管理任务,更多问题请参考 FAQ:REDIS
初始化Redis
您可以使用 redis.yml 剧本来初始化 Redis 集群、节点、或实例:
你也可以使用包装脚本命令行脚本来初始化:
下线Redis
您可以使用 redis-rm.yml 剧本来初始化 Redis 集群、节点、或实例:
你也可以使用包装脚本来下线 Redis 集群/节点/实例:
重新配置Redis
您可以部分执行 redis.yml 剧本来重新配置 Redis 集群、节点、或实例:
请注意,redis 无法在线重载配置,您只能使用 launch 任务进行重启来让配置生效。
使用Redis客户端
使用 redis-cli 访问 Reids 实例:
Redis提供了redis-benchmark工具,可以用于Redis的性能评估,或生成一些负载用于测试。
手工设置Redis从库
https://redis.io/commands/replicaof/
设置Redis主从高可用
Redis独立主从集群可以通过 Redis 哨兵集群配置自动高可用,详细用户请参考 Sentinel官方文档
以四节点沙箱环境为例,一套 Redis Sentinel 集群 redis-meta,可以用来管理很多套独立 Redis 主从集群。
以一主一从的Redis普通主从集群 redis-ms 为例,您需要在每个 Sentinel 实例上,使用 SENTINEL MONITOR 添加目标,并使用 SENTINEL SET 提供密码,高可用就配置完毕了。
如果您想移除某个由 Sentinel 管理的 Redis 主从集群,使用 SENTINEL REMOVE <name> 移除即可。
您可以使用定义在 Sentinel 集群上的 redis_sentinel_monitor 参数,来自动配置管理哨兵监控管理的主库列表。
使用以下命令刷新 Redis 哨兵集群上的纳管主库列表:
剧本
REDIS模块提供了两个剧本,用于拉起/销毁 传统主从Redis集群/节点/实例:
redis.yml:初始Redis集群/节点/实例。redis-rm.yml:移除Redis集群/节点/实例
redis.yml
用于初始化 Redis 的 redis.yml 剧本包含以下子任务:
redis-rm.yml
用于卸载 Redis 的 redis-rm.yml 剧本包含以下子任务:
监控
Pigsty 提供了三个与 REDIS 模块有关的监控仪表盘:
Redis Overview
Redis Overview:关于所有Redis集群/实例的详细信息
Redis Cluster
Redis Cluster:关于单个Redis集群的详细信息
Redis Instance
Redis Instance: 关于单个Redis实例的详细信息
参数
Pigsty中有21个关于Redis模块的配置参数:
| 参数 | 类型 | 级别 | 注释 |
|---|---|---|---|
redis_cluster |
string | C | Redis数据库集群名称,必选身份参数 |
redis_instances |
dict | I | Redis节点上的实例定义 |
redis_node |
int | I | Redis节点编号,正整数,集群内唯一,必选身份参数 |
redis_fs_main |
path | C | Redis主数据目录,默认为 /data |
redis_exporter_enabled |
bool | C | Redis Exporter 是否启用? |
redis_exporter_port |
port | C | Redis Exporter监听端口 |
redis_exporter_options |
string | C/I | Redis Exporter命令参数 |
redis_safeguard |
bool | G/C/A | 禁止抹除现存的Redis |
redis_clean |
bool | G/C/A | 初始化Redis是否抹除现存实例 |
redis_rmdata |
bool | G/C/A | 移除Redis实例时是否一并移除数据? |
redis_mode |
enum | C | Redis集群模式:sentinel,cluster,standalone |
redis_conf |
string | C | Redis配置文件模板,sentinel 除外 |
redis_bind_address |
ip | C | Redis监听地址,默认留空则会绑定主机IP |
redis_max_memory |
size | C/I | Redis可用的最大内存 |
redis_mem_policy |
enum | C | Redis内存逐出策略 |
redis_password |
password | C | Redis密码,默认留空则禁用密码 |
redis_rdb_save |
string[] | C | Redis RDB 保存指令,字符串列表,空数组则禁用RDB |
redis_aof_enabled |
bool | C | Redis AOF 是否启用? |
redis_rename_commands |
dict | C | Redis危险命令重命名列表 |
redis_cluster_replicas |
int | C | Redis原生集群中每个主库配几个从库? |
redis_sentinel_monitor |
master[] | C | Redis哨兵监控的主库列表,只在哨兵集群上使用? |


