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>:6379
          - <哨兵2節點IP>:6379
          - <哨兵3節點IP>:6379
          - <哨兵4節點IP>:6379
          - <哨兵5節點IP>:6379
          - <哨兵6節點IP>:6379
      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