openiamdocker/redis-sentinel

Redis Sentinel 镜像文档

1. 镜像概述

Redis Sentinel 是 Redis 官方提供的高可用解决方案，用于监控 Redis 主从架构中的节点状态，实现自动故障检测、故障转移及配置管理。本镜像基于官方 Redis 镜像构建，封装了 Sentinel 组件，可快速部署至容器环境，为 Redis 集群提供高可用保障。

2. 核心功能与特性

2.1 核心功能

• 节点监控：持续监控 Redis 主节点（master）和从节点（slave）的运行状态。
• 自动故障转移：当主节点不可用时，自动将从节点晋升为新主节点，并更新其他从节点的复制目标。
• 配置提供者：客户端可通过 Sentinel 获取当前主节点地址，无需硬编码主节点信息。
• 通知机制：支持通过脚本触发告警（如邮件、短信），通知管理员节点故障或故障转移事件。

2.2 关键特性

• 分布式架构：支持多 Sentinel 节点部署，通过“投票机制”避免单点故障（需配置 quorum 参数）。
• 动态配置同步：Sentinel 集群间自动同步配置信息，新增/移除节点时无需手动修改配置。
• 兼容性：兼容 Redis 2.8+ 版本，支持 Redis 主从复制、持久化等核心功能。

3. 使用场景与适用范围

3.1 适用场景

• 生产环境 Redis 集群：需避免主节点单点故障的核心业务场景（如电商缓存、会话存储）。
• 主从复制架构：已部署 Redis 主从复制，但需自动化故障处理的场景。
• 无人值守运维：需要减少人工干预的分布式系统（如微服务架构中的 Redis 依赖）。

3.2 不适用场景

• 单节点 Redis 部署（无主从架构时无需 Sentinel）。
• 对故障转移时间敏感（毫秒级）的场景（Sentinel 故障转移耗时通常为秒级）。

4. 使用方法与配置说明

4.1 前置条件

• 已部署 Redis 主从集群（至少 1 主 1 从，推荐 1 主 2 从）。
• 容器环境需开放 Sentinel 通信端口（默认 26379）及 Redis 节点端口（默认 6379）。

4.2 Docker Run 部署示例

4.2.1 基础部署（单 Sentinel 节点）

bash
docker run -d \
  --name redis-sentinel \
  -p 26379:26379 \
  -v /path/to/sentinel.conf:/etc/redis/sentinel.conf \
  redis:alpine \
  redis-sentinel /etc/redis/sentinel.conf

说明：需提前准备 sentinel.conf 配置文件（见 4.4 配置参数），并通过 -v 挂载至容器内。

4.2.2 多 Sentinel 集群部署（3 节点示例）

bash
# 节点 1
docker run -d \
  --name redis-sentinel-1 \
  -p 26379:26379 \
  -v /path/to/sentinel-1.conf:/etc/redis/sentinel.conf \
  --network redis-net \
  redis:alpine redis-sentinel /etc/redis/sentinel.conf

# 节点 2（端口映射 26380，避免宿主机端口冲突）
docker run -d \
  --name redis-sentinel-2 \
  -p 26380:26379 \
  -v /path/to/sentinel-2.conf:/etc/redis/sentinel.conf \
  --network redis-net \
  redis:alpine redis-sentinel /etc/redis/sentinel.conf

# 节点 3（端口映射 26381）
docker run -d \
  --name redis-sentinel-3 \
  -p 26381:26379 \
  -v /path/to/sentinel-3.conf:/etc/redis/sentinel.conf \
  --network redis-net \
  redis:alpine redis-sentinel /etc/redis/sentinel.conf

说明：需创建自定义网络 redis-net（docker network create redis-net），确保 Sentinel 与 Redis 节点在同一网络。

4.3 Docker Compose 部署示例

以下示例包含 1 主、2 从、3 Sentinel 节点的完整架构：

yaml
version: '3'

networks:
  redis-net:
    driver: bridge

services:
  # Redis 主节点
  redis-master:
    image: redis:alpine
    container_name: redis-master
    ports:
      - "6379:6379"
    networks:
      - redis-net
    command: redis-server --appendonly yes  # 开启 AOF 持久化

  # Redis 从节点 1
  redis-slave-1:
    image: redis:alpine
    container_name: redis-slave-1
    ports:
      - "6380:6379"
    networks:
      - redis-net
    command: redis-server --slaveof redis-master 6379  # 指向主节点

  # Redis 从节点 2
  redis-slave-2:
    image: redis:alpine
    container_name: redis-slave-2
    ports:
      - "6381:6379"
    networks:
      - redis-net
    command: redis-server --slaveof redis-master 6379  # 指向主节点

  # Sentinel 节点 1
  sentinel-1:
    image: redis:alpine
    container_name: sentinel-1
    ports:
      - "26379:26379"
    networks:
      - redis-net
    volumes:
      - ./sentinel-1.conf:/etc/redis/sentinel.conf
    command: redis-sentinel /etc/redis/sentinel.conf

  # Sentinel 节点 2
  sentinel-2:
    image: redis:alpine
    container_name: sentinel-2
    ports:
      - "26380:26379"
    networks:
      - redis-net
    volumes:
      - ./sentinel-2.conf:/etc/redis/sentinel.conf
    command: redis-sentinel /etc/redis/sentinel.conf

  # Sentinel 节点 3
  sentinel-3:
    image: redis:alpine
    container_name: sentinel-3
    ports:
      - "26381:26379"
    networks:
      - redis-net
    volumes:
      - ./sentinel-3.conf:/etc/redis/sentinel.conf
    command: redis-sentinel /etc/redis/sentinel.conf

注：所有 Sentinel 配置文件（sentinel-1.conf、sentinel-2.conf、sentinel-3.conf）需包含相同的监控配置（见 4.4 配置参数）。

4.4 配置参数详解

Sentinel 配置通过 sentinel.conf 文件定义，核心参数如下：

示例配置文件（sentinel.conf）：

conf
# 监控名为 "mymaster" 的主节点（IP：redis-master，端口：6379，仲裁数：2）
sentinel monitor mymaster redis-master 6379 2

# 主节点无响应 10 秒后标记为下线
sentinel down-after-milliseconds mymaster 10000

# 故障转移时允许 1 个从节点同时同步
sentinel parallel-syncs mymaster 1

# 故障转移超时时间 2 分钟
sentinel failover-timeout mymaster 120000

5. 环境变量说明

为简化配置，可通过环境变量动态注入 Sentinel 参数（无需手动编写 sentinel.conf），常用变量如下：

使用环境变量的 Docker Run 示例：

bash
docker run -d \
  --name redis-sentinel \
  -p 26379:26379 \
  --network redis-net \
  -e SENTINEL_MONITOR_NAME=mymaster \
  -e REDIS_MASTER_HOST=redis-master \
  -e REDIS_MASTER_PORT=6379 \
  -e SENTINEL_QUORUM=2 \
  -e SENTINEL_DOWN_AFTER=10000 \
  redis:alpine \
  redis-sentinel --sentinel

6. 客户端接入

客户端需通过 Sentinel 获取当前主节点地址，而非直接连接主节点。以 Redis CLI 为例：

bash
# 连接 Sentinel（端口 26379）
redis-cli -h 127.0.0.1 -p 26379

# 获取主节点信息
sentinel get-master-addr-by-name mymaster
# 输出示例：1) "redis-master" 2) "6379"（故障转移后将返回新主节点地址）

主流 Redis 客户端（如 Jedis、Lettuce）均内置 Sentinel 支持，配置示例（Java Jedis）：

java
Set<String> sentinelSet = new HashSet<>();
sentinelSet.add("127.0.0.1:26379");
sentinelSet.add("127.0.0.1:26380");
sentinelSet.add("127.0.0.1:26381");

JedisSentinelPool pool = new JedisSentinelPool("mymaster", sentinelSet);
Jedis jedis = pool.getResource();