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 192.168.1.111:6380

参考资料

Scale with Redis Cluster | Docs

99_springboot整合redis之连接集群-下集_哔哩哔哩_bilibili