# 如何使用redis-trib.rb搭建集群

## 前言

Redis Cluster是Redis官方提供的分布式解决方案，通过数据分片（sharding）实现水平扩展。`redis-trib.rb`是Redis官方提供的集群管理工具（Ruby编写），虽然Redis 5.0后推荐使用`redis-cli --cluster`，但了解传统方式仍有价值。本文将详细介绍使用`redis-trib.rb`搭建Redis集群的全过程。

---

## 环境准备

### 1. 基础要求
- 至少**3个主节点**（正式环境建议每个主节点配1个从节点，共6节点）
- 每个节点需开启**集群模式**（`cluster-enabled yes`）
- 确保节点间**端口互通**（通常需开放数据端口+10000的集群总线端口）

### 2. 软件依赖
```bash
# 安装Ruby和Redis gem
sudo apt-get install ruby        # Ubuntu/Debian
sudo yum install ruby            # CentOS/RHEL
gem install redis -v 3.3.5       # 注意版本兼容性

集群搭建步骤

1. 启动Redis节点

修改每个节点的redis.conf：

port 6379
cluster-enabled yes
cluster-config-file nodes.conf
cluster-node-timeout 5000
daemonize yes

启动所有节点：

redis-server /path/to/redis.conf

2. 使用redis-trib.rb创建集群

# 基本命令格式
./redis-trib.rb create --replicas 1 \
  192.168.1.101:6379 \
  192.168.1.102:6379 \
  192.168.1.103:6379 \
  192.168.1.104:6379 \
  192.168.1.105:6379 \
  192.168.1.106:6379

参数说明： - --replicas 1：每个主节点配1个从节点 - 前3个IP会被默认设为主节点

执行后会显示分片方案，输入yes确认：

>>> Creating cluster
>>> Performing hash slots allocation...
M: 2936f3... 192.168.1.101:6379
   slots:0-5460 (5461 slots)
M: e3c7d9... 192.168.1.102:6379
   slots:5461-10922 (5462 slots)
M: 43a1a8... 192.168.1.103:6379
   slots:10923-16383 (5461 slots)
S: 1b2e3f... 192.168.1.104:6379
   replicates 2936f3...
Can I set the above configuration? (type 'yes' to accept): yes

3. 验证集群状态

# 检查集群状态
./redis-trib.rb check 192.168.1.101:6379

# 输出关键信息示例
[OK] All nodes agree about slots configuration.
>>> Check for open slots...
>>> Check slots coverage...
[OK] All 16384 slots covered.

集群管理操作

1. 添加新节点

# 添加主节点
./redis-trib.rb add-node new_host:6379 existing_host:6379

# 添加从节点（需指定主节点ID）
./redis-trib.rb add-node --slave --master-id <master-id> new_host:6379 existing_host:6379

2. 重新分片

./redis-trib.rb reshard existing_host:6379

按提示输入： - 迁移的slot数量（如1000） - 目标节点ID - 源节点ID（输入all从所有节点平均迁移）

3. 故障转移测试

手动关闭某个主节点，观察从节点是否自动接替：

redis-cli -h 192.168.1.101 -p 6379 DEBUG SEGFAULT

常见问题解决

1. Ruby版本问题

若报错redis requires Ruby version >= 2.3.0：

# 使用RVM管理Ruby版本
curl -sSL https://get.rvm.io | bash -s stable
rvm install 2.6
rvm use 2.6 --default

2. 节点无法握手

检查： - 防火墙是否开放端口（数据端口和集群总线端口） - 配置文件是否设置bind 0.0.0.0 - 日志中的错误信息（/var/log/redis/redis.log）

3. Slot未完全分配

若出现[ERR] Not all 16384 slots are covered：

# 手动修复未分配的slot
./redis-trib.rb fix existing_host:6379

集群维护建议

1. 监控工具：

   • 使用redis-cli --cluster info查看简要状态
   • 通过CLUSTER NODES命令获取详细拓扑

2. 备份策略： “`bash

   备份集群配置

   redis-cli -h -p CLUSTER SAVECONFIG

# 定期备份AOF/RDB文件 cp /var/lib/redis/dump.rdb /backup/

3. **版本升级**：
   - 先升级从节点，再手动故障转移升级主节点
   - 确保所有节点版本一致

---

## 总结

通过`redis-trib.rb`工具，我们能够快速搭建和管理Redis集群。虽然新版本推荐使用`redis-cli --cluster`，但理解底层原理对运维复杂集群至关重要。建议在生产环境中：
- 使用至少6节点（3主3从）保证高可用
- 定期检查集群状态和slot分布
- 做好监控和报警设置

> 注意：Redis 5+用户可直接使用`redis-cli --cluster create`命令，其参数与`redis-trib.rb`基本一致。