当前位置： 首页 > article >正文

Docker 环境中搭建 Redis 哨兵模式集群的步骤与问题解决

article 2025/1/6 20:03:24

在 Docker 环境中搭建 Redis 哨兵模式集群的步骤与问题解决

在 Redis 高可用架构中，哨兵模式（Sentinel）是确保 Redis 集群在出现故障时自动切换主节点的一种机制。通过使用 Redis 哨兵，我们可以实现 Redis 集群的监控、故障检测和自动故障转移。在本篇文章中，我将带大家了解如何在 Docker 环境中搭建一个 Redis 哨兵模式集群，并解决在连接时遇到的一些问题。

一、准备工作

  1. Docker 环境
    首先确保你的机器已经安装并配置了 Docker 和 Docker Compose。

  2. 网络配置
    我们将创建一个 Docker 网络，用于 Redis 集群中的容器间通信。在 Docker Compose 配置文件中，我们使用了 bridge 网络模式，并且为容器分配了静态 IP 地址，以确保容器间的稳定连接。

二、Docker Compose 配置文件

我们将通过 Docker Compose 部署 Redis 集群。以下是 docker-compose.yml 文件的配置内容：

version: "3"

networks:
  redis-replication:
    driver: bridge
    ipam:
      config:
        - subnet: 172.25.0.0/24

services:
  master:
    image: redis
    container_name: redis-master
    ports:
      - "6371:6379"
    volumes:
      - "./master/redis.conf:/etc/redis.conf"
      - "./master/data:/data"
    command: ["redis-server", "/etc/redis.conf"]
    restart: always
    networks:
      redis-replication:
        ipv4_address: 172.25.0.101

  slave1:
    image: redis
    container_name: redis-slave-1
    ports:
      - "6372:6379"
    volumes:
      - "./slave1/redis.conf:/etc/redis.conf"
      - "./slave1/data:/data"
    command: ["redis-server", "/etc/redis.conf"]
    restart: always
    networks:
      redis-replication:
        ipv4_address: 172.25.0.102

  slave2:
    image: redis
    container_name: redis-slave-2
    ports:
      - "6373:6379"
    volumes:
      - "./slave2/redis.conf:/etc/redis.conf"
      - "./slave2/data:/data"
    command: ["redis-server", "/etc/redis.conf"]
    restart: always
    networks:
      redis-replication:
        ipv4_address: 172.25.0.103

  sentinel1:
    image: redis
    container_name: redis-sentinel-1
    ports:
      - "26380:26379"
    volumes:
      - "./sentinel1/sentinel.conf:/etc/sentinel.conf"
    command: ["/bin/bash", "-c", "cp /etc/sentinel.conf /sentinel.conf && redis-sentinel /sentinel.conf"]
    restart: always
    networks:
      redis-replication:
        ipv4_address: 172.25.0.201

  sentinel2:
    image: redis
    container_name: redis-sentinel-2
    ports:
      - "26381:26379"
    volumes:
      - "./sentinel2/sentinel.conf:/etc/sentinel.conf"
    command: ["/bin/bash", "-c", "cp /etc/sentinel.conf /sentinel.conf && redis-sentinel /sentinel.conf"]
    restart: always
    networks:
      redis-replication:
        ipv4_address: 172.25.0.202

  sentinel3:
    image: redis
    container_name: redis-sentinel-3
    ports:
      - "26382:26379"
    volumes:
      - "./sentinel3/sentinel.conf:/etc/sentinel.conf"
    command: ["/bin/bash", "-c", "cp /etc/sentinel.conf /sentinel.conf && redis-sentinel /sentinel.conf"]
    restart: always
    networks:
      redis-replication:
        ipv4_address: 172.25.0.203

在这个配置文件中，我们部署了：

1 个 Redis 主节点（master）。
2 个 Redis 从节点（slave1 和 slave2）。
3 个 Redis 哨兵节点（sentinel1、sentinel2、sentinel3）。
每个 Redis 容器都有单独的配置文件，并通过 volumes 映射到宿主机。我们使用了 Docker 的 bridge 网络模式，并为每个容器分配了静态 IP 地址，确保容器之间能够稳定通信。

三、Redis 配置文件

配置文件目录结构如下：

redis-sentinel-cluster/
├── docker-compose.yml
├── master/
│   └── redis.conf             
├── slave1/
│   └── redis.conf             # Redis 从节点配置文件
├── slave2/
│   └── redis.conf             # Redis 从节点配置文件
├── sentinel1/
│   └── sentinel.conf          # Redis Sentinel 配置文件
├── sentinel2/
│   └── sentinel.conf          # Redis Sentinel 配置文件
├── sentinel3/
│   └── sentinel.conf          # Redis Sentinel 配置文件
└── data/                       # 数据目录，用于持久化 Redis 数据

每个 Redis 节点都需要配置相应的配置文件，以下是关键配置内容：

  1. 主节点（Master）配置：
port 6379
protected-mode no
slave-serve-stale-data yes
replicaof no one
appendonly yes
  1. 从节点（Slave）配置（2个slave配置文件一致）：
port 6379
bind 0.0.0.0
protected-mode no
replicaof 172.25.0.101 6379
appendonly yes
dir /data
  1. 哨兵（Sentinel）配置（3个sentinel配置文件一致）：
sentinel monitor mymaster 10.28.145.144 6371 2
sentinel parallel-syncs mymaster 1
sentinel down-after-milliseconds mymaster 30000
sentinel failover-timeout mymaster 180000

注意：在哨兵的配置中，我们指定了主节点的 IP 地址为 10.28.145.144（即本机地址）以及映射的端口 6371。

四、启动服务

docker-compose up -d

启动容器

docker-compose ps

在这里插入图片描述

四、遇到的问题

连接哨兵集群的代码：

package main

import (
	"context"
	"fmt"

	"log"
	"time"

	"github.com/go-redis/redis/v8"
)

var rdb *redis.Client

func main() {
	// 定义 Redis 哨兵集群的地址
	sentinelAddrs := []string{
		"127.0.0.1:26380",
		"127.0.0.1:26381",
		"127.0.0.1:26382",
	}

	// 配置 Redis 哨兵模式连接
	options := &redis.FailoverOptions{
		MasterName:    "mymaster",    // 设定主节点名字
		SentinelAddrs: sentinelAddrs, // 哨兵地址
		Password:      "",            // 设置密码（如果有）
		DB:            0,             // 数据库索引
	}

	// 创建 Redis 客户端
	rdb = redis.NewFailoverClient(options)

	// 测试连接
	ctx, cancel := context.WithTimeout(context.Background(), 25*time.Second)
	defer cancel()

	_, err := rdb.Ping(ctx).Result()
	if err != nil {
		log.Fatalf("无法连接到 Redis 哨兵集群: %v", err)
	}

	fmt.Println("成功连接到 Redis 哨兵集群")

	// 执行其他 Redis 操作
	setAndGet(ctx)
}

func setAndGet(ctx context.Context) {
	// 示例：设置键值对并获取
	err := rdb.Set(ctx, "mykey", "Hello Redis!", 0).Err()
	if err != nil {
		log.Fatalf("无法设置键值对: %v", err)
	}

	val, err := rdb.Get(ctx, "mykey").Result()
	if err != nil {
		log.Fatalf("无法获取键值对: %v", err)
	}

	fmt.Printf("获取的值: %s\n", val)
}

在进行 Redis 哨兵集群连接时，遇到了以下问题：

  1. 问题描述：
    在尝试通过 Go 语言客户端连接 Redis 哨兵集群时，报错信息为：
redis: 2025/01/03 09:58:07 sentinel.go:700: sentinel: discovered new sentinel="172.25.0.202:26379" for master="mymaster"
redis: 2025/01/03 09:58:07 sentinel.go:700: sentinel: discovered new sentinel="172.25.0.203:26379" for master="mymaster"
redis: 2025/01/03 09:58:07 sentinel.go:661: sentinel: new master="mymaster" addr="172.25.0.101:6379"
2025/01/03 09:58:32 无法连接到 Redis 哨兵集群: context deadline exceeded

经过分析，发现错误是由于 Go 客户端连接 Redis 哨兵集群时，Redis 哨兵返回的主节点地址是 Docker 内部的 IP 地址（例如：172.25.0.101:6379），而 Go 客户端无法直接连接该地址。

  1. 原因分析：
    由于容器内的 IP 地址在宿主机和外部环境中不可访问，因此客户端无法通过这些 IP 地址与 Redis 集群进行通信。为了确保 Redis 哨兵能够返回宿主机可以访问的 IP 地址，我们需要在 Redis 配置和 Sentinel 配置中做一些调整。

五、问题解决方案

为了解决以上问题，我们需要确保 Redis 哨兵返回正确的主节点 IP 地址。以下是解决方案：

  1. 修改 Sentinel 配置：
    在 Sentinel 的配置中，将主节点的 IP 地址改为宿主机的 IP 地址。修改如下：
    sentinel monitor mymaster 10.28.145.144 6371 2

这样，Redis 哨兵就会将主节点的地址返回为宿主机的 IP 地址，从而使客户端能够正确连接到 Redis 集群。
连接成功
注意：此处只是临时解决方案，如果这样强制写死，虽然能正常访问，但哨兵集群发生故障迁移时，仍然会出现这个问题，最终解决方案待更新。

六、总结

通过 Docker 部署 Redis 哨兵集群，可以轻松实现 Redis 的高可用性。然而，在容器化环境下，尤其是 Docker 桥接网络模式中，我们需要特别注意容器之间的通信和外部访问。在本文中，我们分析了在连接 Redis 哨兵集群时遇到的网络问题，并给出了有效的解决方案。通过调整 Sentinel 配置，将主节点的 IP 地址设置为宿主机的 IP 地址，解决了客户端无法连接 Redis 集群的问题。最终，我们成功实现了 Docker 环境下 Redis 哨兵模式集群的高可用部署。希望本文对你在 Docker 环境下搭建 Redis 哨兵集群有所帮助。如有任何问题，欢迎留言讨论！


http://www.kler.cn/a/466303.html

相关文章：

  • Qt 5.14.2 学习记录 —— 일 新项目
  • Easticsearch介绍|实战?
  • MySQL 索引分类及区别与特点
  • 基于HTML和CSS的旅游小程序
  • 《学校一卡通管理系统》数据库MySQL的设计与实现
  • Springboot 下载附件
  • 常见的九种二极管
  • 代码随想录算法训练营第五十二天|KM101.孤岛的总面积|KM102.沉没孤岛|KM103.水流问题|KM104.建造最大岛屿
  • SQLite简介：轻量级数据库入门
  • 57.在 Vue 3 中使用 OpenLayers 点击选择 Feature 设置特定颜色
  • 断舍离：通往心灵自由的五级阶梯
  • JavaScript系列（4）--数值类型专题
  • js获取下拉单选框的值和显示的值
  • springboot整合Quartz实现定时任务
  • 趣味编程：心形曲线
  • Linux环境（CentOs7） 安装 Node环境
  • 最近学习shader的一些总结
  • npm ERR! ECONNRESET 解决方法
  • Celeborn Spark 集成最新进展
  • 滤波器的主要参数
  • Flutter路由钩子
  • 1月2日作业
  • 酒店管理系统｜Java｜SSM｜VUE｜ 前后端分离
  • [文献阅读] Reducing the Dimensionality of Data with Neural Networks
  • 查找最长回文子串
  • 七种改进爬山算法的方法