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

99_springboot整合redis之連線叢集-下集_嗶哩嗶哩_bilibili