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

sentinel.conf

复制出来

概览

结构如上图所示，准备6个服务器。

配置哨兵节点

1.创建 redis-sentinel 目录

2.创建 redis-sentinel/docker-compose.yml 文件

services:
  redis-sentinel:
    image: redis:7.2.5
    ports:
      - "26379:26379"
    volumes:
      - ./data:/data
    restart: always
    command: redis-sentinel /data/sentinel.conf

3.创建 redis-sentinel/data 目录

4.配置文件复制到 redis-sentinel/data/sentinel.conf

5.添加/覆盖配置项

logfile "/data/redis.log"
sentinel monitor mymaster <主节点IP> 6379 2
sentinel down-after-milliseconds mymaster 5000
sentinel failover-timeout mymaster 60000
sentinel auth-pass mymaster abc123

#这个是 Docker 关键配置，不然发给其他哨兵的是容器内部ip：
sentinel announce-ip <当前哨兵节点IP>

6.在三个哨兵节点分别执行上述5个步骤

配置主从节点

1.创建 redis 目录

2.创建 redis/docker-compose.yml 文件

services:
  redis:
    image: redis:7.2.5
    ports:
      - "6379:6379"
    volumes:
      - ./data:/data
    restart: always
    command: redis-server /data/redis.conf

3.创建 redis/data 目录

4.配置文件复制到 redis/data/redis.conf

5.添加/覆盖配置项

#注释掉这项：
#bind 127.0.0.1 -::1

logfile "/data/redis.log"
masterauth abc123
requirepass abc123

#这个仅配置到从节点：
replicaof <主节点IP> 6379

 
6.在主从节点分别执行上述5个步骤

启动顺序

1.启动主节点

cd 到 redis 目录，执行 docker compose up -d

2.启动从节点

cd 到 redis 目录，执行 docker compose up -d

3.启动哨兵节点

cd 到 redis-sentinel 目录，执行 docker compose up -d

整合SpringBoot

1.添加依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

2.添加配置

spring:
  data:
    redis:
      password: abc123
      sentinel:
        master: mymaster
        nodes:
          - <哨兵1节点IP>:26379
          - <哨兵2节点IP>:26379
          - <哨兵3节点IP>:26379

3.配置读写分离

不建议配，除非主节点压力很大，主节点新数据更新到从节点需要时间，这段时间会出现数据不一致。

@Configuration
public class RedisConfig {
    @Bean
    public LettuceClientConfigurationBuilderCustomizer clientConfigurationBuilderCustomizer() {
        return builder -> builder.readFrom(ReadFrom.REPLICA_PREFERRED);
    }
}

4.完成，可直接使用 RedisTemplate

参考资料

High availability with Redis Sentinel | Docs

Redis replication | Docs