Redis 与缓存 / 系统课时

搭建基础 Redis Cluster

搭建基础 Redis Cluster

本篇用本机 7000~7005 六个 Redis 实例搭建一个 3 主 3 从的基础 Cluster,并从槽位覆盖、主从角色和集群状态三个角度完成验收。完成后,你会得到一个可继续练习重定向、故障转移与扩缩容的本地实验集群。

学习目标

  • 创建 6 个启用 Cluster 模式且彼此隔离的 Redis 实例。
  • 使用 redis-cli --cluster create 组成 3 主 3 从集群。
  • 检查 16384 个槽位是否完整覆盖,并识别主节点与副本节点状态。

准备六个集群节点

同一台机器可以用不同端口模拟多个节点。关键是让每个实例拥有独立工作目录和独立的 nodes.conf;这个文件由 Redis 自己维护,不应手工编辑。下面的脚本只绑定到回环地址,适合本地实验,不应直接作为生产配置。

bash
mkdir -p redis-cluster-lab
cd redis-cluster-lab

for port in 7000 7001 7002 7003 7004 7005; do
  mkdir -p "$port"
  cat > "$port/redis.conf" <<EOF
port $port
bind 127.0.0.1
protected-mode yes
cluster-enabled yes
cluster-config-file "$(pwd)/$port/nodes.conf"
cluster-node-timeout 5000
appendonly yes
daemonize yes
dir "$(pwd)/$port"
logfile "$(pwd)/$port/redis.log"
pidfile "$(pwd)/$port/redis.pid"
EOF

  redis-server "$port/redis.conf"
done

for port in 7000 7001 7002 7003 7004 7005; do
  printf "%s " "$port"
  redis-cli -p "$port" PING
done

预期输出

text
7000 PONG
7001 PONG
7002 PONG
7003 PONG
7004 PONG
7005 PONG

如果某个端口没有返回 PONG,先检查对应目录下的 redis.log,不要在节点未全部启动时继续创建集群。

创建三主三从集群

把六个实例交给 redis-cli 分配槽位和复制关系。--cluster-replicas 1 表示每个主节点配置 1 个副本,因此六个节点最终形成 3 个主节点和 3 个副本节点。

bash
redis-cli --cluster create \
  127.0.0.1:7000 127.0.0.1:7001 127.0.0.1:7002 \
  127.0.0.1:7003 127.0.0.1:7004 127.0.0.1:7005 \
  --cluster-replicas 1 \
  --cluster-yes

预期输出的关键部分

text
>>> Performing hash slots allocation on 6 nodes...
...
[OK] All 16384 slots covered.

节点 ID、配置纪元和具体副本配对由实际创建过程决定,因此这些动态值不应写死。验收重点是三个主节点共同覆盖全部 16384 个哈希槽,并且每个主节点都有一个副本。

3 主 3 从 Redis Cluster 的槽位与复制拓扑

检查槽位和集群状态

先检查集群级状态,再查看节点表。健康的基础集群应报告 cluster_state:ok、6 个已知节点、3 个主分片,并且 16384 个槽位全部处于正常状态。

bash
redis-cli -p 7000 CLUSTER INFO \
  | grep -E '^cluster_(state|slots_assigned|slots_ok|known_nodes|size):'

redis-cli --cluster check 127.0.0.1:7000

预期输出的关键部分

text
cluster_state:ok
cluster_slots_assigned:16384
cluster_slots_ok:16384
cluster_known_nodes:6
cluster_size:3
...
[OK] All 16384 slots covered.

再读取节点视图,确认三条主节点记录带有槽位范围,另外三条记录是副本角色。

bash
redis-cli -p 7000 CLUSTER NODES

预期输出形态

text
<ID> 127.0.0.1:7000@17000 myself,master - 0 <TIME> <EPOCH> connected 0-5460
<ID> 127.0.0.1:<PORT>@<PORT> master - 0 <TIME> <EPOCH> connected <SLOT_RANGE>
<ID> 127.0.0.1:<PORT>@<PORT> master - 0 <TIME> <EPOCH> connected <SLOT_RANGE>
<ID> 127.0.0.1:<PORT>@<PORT> slave <MASTER_ID> 0 <TIME> <EPOCH> connected
...

实际节点顺序、节点 ID、复制目标、配置纪元和端口行顺序都可能不同。重点看 master 节点的槽位范围彼此不重叠且合计覆盖 0~16383,副本节点则指向某个主节点 ID。

处理基础搭建失败

如果创建命令提示节点已有数据或已有集群配置,通常是之前的实验残留。应先停止这些测试实例,清理对应实验目录中的旧数据和旧 nodes.conf,再重新启动;不要在仍承载有效数据的节点上直接删除集群元数据。

若节点都能 PING,但集群一直无法汇合,检查节点之间的集群总线是否可达。本地默认端口 7000~7005 通常对应集群总线端口 17000~17005;跨主机部署时,客户端端口和集群总线端口都必须按实际配置互通。最终只有同时满足 cluster_state:ok 与 16384 个槽位完整覆盖,才算基础 Redis Cluster 搭建完成。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建基础 Redis Cluster

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通