Redis 結合 Docker 搭建哨兵+主從，並整合SpringBoot

Yfeil發表於2024-06-04
RedisDockerSpring Boot

軟體版本

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

複製出來

概覽

Redis 結合 Docker 搭建哨兵+主從，並整合SpringBoot

結構如上圖所示，準備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 "" 改成： logfile "/data/redis.log"

sentinel monitor mymaster 127.0.0.1 6379 2 改成：sentinel monitor mymaster <主節點IP> 6379 2

sentinel down-after-milliseconds mymaster 30000 改成：sentinel down-after-milliseconds mymaster 5000

sentinel failover-timeout mymaster 180000 改成：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 "" 改成： 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

相關文章