Redis 结合 Docker 搭建集群,并整合SpringBoot
软件版本
Redis 7.2.5
Docker 26.1.3
准备工作
由于docker直接拉取运行了,所以需要提前准备配置文件
Index of /releases/ (redis.io)
下载后,把redis-7.2.5.tar.gz\redis-7.2.5.tar\redis-7.2.5\里的
redis.conf
复制出来
概览
结构如上图所示,准备6个服务器。
配置各节点
1.创建 redis-cluster 目录
2.创建 redis-cluster/docker-compose.yml 文件
services:
redis-cluster:
image: redis:7.2.5
ports:
- "6379:6379"
- "16379:16379"
volumes:
- ./data:/data
restart: always
command: redis-server /data/redis.conf
3.创建 redis-cluster/data 目录
4.配置文件复制到 redis-cluster/data/redis.conf
5.添加/覆盖配置项
#注释掉这项:
#bind 127.0.0.1 -::1
logfile "/data/redis.log"
appendonly yes
cluster-enabled yes
cluster-config-file nodes.conf
cluster-node-timeout 5000
#这个是 Docker 关键配置,不然发给其他节点的是容器内部ip:
cluster-announce-ip <当前节点IP>
6.在六个节点分别执行上述5个步骤
启动集群
1.启动所有节点
cd 到 redis-cluster 目录,执行 docker compose up -d
2.创建集群
进入任意节点的 redis 容器内,执行如下命令:
redis-cli --cluster create \
<节点1的IP>:6379 \
<节点2的IP>:6379 \
<节点3的IP>:6379 \
<节点4的IP>:6379 \
<节点5的IP>:6379 \
<节点6的IP>:6379 \
--cluster-replicas 1
按提示输入yes
:
创建成功提示如下:
整合SpringBoot
1.添加依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
2.添加配置
spring:
data:
redis:
cluster:
nodes:
- <哨兵1节点IP>:6380
- <哨兵2节点IP>:6380
- <哨兵3节点IP>:6380
- <哨兵4节点IP>:6380
- <哨兵5节点IP>:6380
- <哨兵6节点IP>:6380
lettuce:
cluster:
refresh:
adaptive: true
3.配置读写分离
不建议配,除非主节点压力很大,主节点新数据更新到从节点需要时间,这段时间会出现数据不一致。
@Configuration
public class RedisConfig {
@Bean
public LettuceClientConfigurationBuilderCustomizer clientConfigurationBuilderCustomizer() {
return builder -> builder.readFrom(ReadFrom.REPLICA_PREFERRED);
}
}
4.完成,可直接使用 RedisTemplate
扩展
重新分配哈希槽
执行:
redis-cli --cluster reshard <任意节点IP>:6379
输入分配的哈希槽数量:
输入分配给的节点ID:
输入用于分配哈希槽的节点,可以直接输入all
:
确认分配计划输入yes
:
完毕。
节点管理
# 添加新主节点
redis-cli --cluster add-node <新节点IP>:6379 <任意节点IP>:6379
# 添加新从节点
# 由于没指定主节点,新添加的从节点会分配给副本最少的主节点
redis-cli --cluster add-node <新节点IP>:6379 <任意节点IP>:6379 --cluster-slave
# 添加新从节点,并指定主节点
redis-cli --cluster add-node <新节点IP>:6379 <任意节点IP>:6379 --cluster-slave --cluster-master-id <主节点ID>
# 删除节点
# 从节点可直接删除,主节点必须先转移哈希槽
redis-cli --cluster del-node <任意节点IP>:6379 <待删节点ID>
# 查看所有集群节点信息
redis-cli --cluster check <任意节点IP>:6379
参考资料
Scale with Redis Cluster | Docs