powerhome/redis-operator

Redis Operator 技术文档

概述

Redis Operator是一个在Kubernetes环境中部署和管理高可用Redis集群的操作符（Operator）。它基于Kubernetes的自定义资源定义（CRD），通过集成Sentinel实现Redis主从架构的自动故障转移，简化Redis集群的部署、扩展和日常维护流程，适用于需要在Kubernetes上运行高可用Redis服务的场景。

核心功能与特性

1. Kubernetes原生管理

• 基于自定义资源定义（CRD）：通过RedisCluster等自定义资源描述Redis集群配置，符合Kubernetes原生资源管理方式。
• 声明式配置：支持通过YAML文件定义集群规格，Operator自动将配置转换为实际运行的Redis集群实例。

2. 高可用架构

• 主从自动部署：自动创建Redis主从节点集群，默认配置1主N从架构（从节点数量可自定义）。
• Sentinel集成：同步部署Sentinel集群，持续监控Redis主从节点健康状态。
• 自动故障转移：当主节点故障时，Sentinel自动从从节点中选举新主节点，并更新集群配置，无需人工干预。

3. 简化运维

• 自动扩缩容：支持通过修改CRD资源的replicas字段调整从节点数量，Operator自动完成节点添加/移除。
• 配置持久化：Redis配置参数（如内存限制、数据策略等）通过CRD定义，修改后自动应用到集群。
• 存储管理：支持指定持久化存储类型（如PVC），确保Redis数据持久化存储。

4. 监控与可观测性

• 指标暴露：集成Prometheus监控指标，可通过Prometheus Operator或自定义ServiceMonitor采集Redis和Sentinel的性能指标（如内存使用率、命中率、主从同步状态等）。
• 事件通知：集群状态变更（如故障转移、扩缩容）通过Kubernetes事件机制记录，便于问题排查。

使用场景

适用范围

• Kubernetes环境中的Redis部署：适用于所有基于Kubernetes运行容器化应用的场景，需通过容器化方式管理Redis服务。
• 高可用业务需求：对服务可用性要求高的业务（如电商交易、实时数据处理、缓存服务等），需避免因Redis单点故障导致的服务中断。
• 简化运维成本：需要减少Redis集群手动运维工作（如主从切换、节点扩缩容、配置更新）的团队或企业。
• 云原生架构集成：作为云原生应用的缓存或数据存储组件，与Kubernetes生态（如服务网格、CI/CD流水线）深度集成。

使用方法与配置说明

部署前提

• Kubernetes集群版本≥1.19（支持CRD v1版本）。
• 集群已启用RBAC（Role-Based Access Control）。
• 如需持久化存储，需提前配置Kubernetes存储类（StorageClass）。

部署步骤

1. 安装Redis Operator

通过YAML文件部署CRD和Operator控制器：

bash
# 部署CRD（自定义资源定义）
kubectl apply -f https://raw.githubusercontent.com/[redis-operator-repo]/main/config/crd/bases/redis.redis-operator.io_redisclusters.yaml

# 部署Operator控制器（包含Deployment、ServiceAccount、Role等资源）
kubectl apply -f https://raw.githubusercontent.com/[redis-operator-repo]/main/config/manager/manager.yaml

2. 创建Redis集群

通过RedisCluster自定义资源定义Redis集群规格，示例配置文件（redis-cluster.yaml）：

yaml
apiVersion: redis.redis-operator.io/v1alpha1
kind: RedisCluster
metadata:
  name: example-redis
  namespace: default
spec:
  # Redis集群规格
  redis:
    replicas: 2  # 从节点数量（主节点固定1个，总Redis节点数=1+replicas）
    image: redis:7.0-alpine  # Redis镜像版本
    resources:  # 资源限制
      requests:
        cpu: 500m
        memory: 512Mi
      limits:
        cpu: 1000m
        memory: 1Gi
    config:  # Redis配置参数
      maxmemory: "1G"
      maxmemory-policy: "allkeys-lru"
      appendonly: "yes"  # 启用AOF持久化
    storage:  # 存储配置
      volumeClaimTemplate:
        spec:
          accessModes: ["ReadWriteOnce"]
          storageClassName: "standard"  # 指定存储类
          resources:
            requests:
              storage: 10Gi  # 每个Redis节点的存储容量

  # Sentinel规格
  sentinel:
    replicas: 3  # Sentinel节点数量（建议≥3以保证高可用）
    image: redis:7.0-alpine  # Sentinel镜像（通常与Redis镜像版本一致）
    resources:
      requests:
        cpu: 100m
        memory: 128Mi
      limits:
        cpu: 200m
        memory: 256Mi

应用配置创建集群：

bash
kubectl apply -f redis-cluster.yaml

3. 验证集群状态

检查Redis集群和Sentinel集群是否正常运行：

bash
# 查看Redis节点Pod
kubectl get pods -l app=example-redis-redis

# 查看Sentinel节点Pod
kubectl get pods -l app=example-redis-sentinel

# 查看自定义资源状态
kubectl get redisclusters example-redis -o yaml

核心配置参数说明

扩缩容示例

修改Redis集群从节点数量（如从2个扩至3个）：

bash
# 编辑RedisCluster资源
kubectl edit redisclusters example-redis

# 修改spec.redis.replicas字段为3，保存退出

Operator将自动创建新的Redis从节点并加入集群。

总结

Redis Operator通过Kubernetes Operator模式，将Redis集群的部署、高可用保障和运维操作标准化、自动化，帮助用户在Kubernetes上高效管理高可用Redis服务，降低人工运维成本，提升集群可靠性。适用于各类需要在容器化环境中运行Redis的业务场景，尤其适合对服务可用性和运维效率有较高要求的企业级应用。