Redis-Operator CRD详解：自定义资源定义与使用指南

Redis-Operator CRD详解：自定义资源定义与使用指南

【免费下载链接】redis-operatorA golang based redis operator that will make/oversee Redis standalone/cluster/replication/sentinel mode setup on top of the Kubernetes.项目地址: https://gitcode.com/gh_mirrors/red/redis-operator

Redis-Operator 是一个基于 Golang 开发的 Kubernetes 运算符，能够在 Kubernetes 集群上自动化部署和管理 Redis 的多种部署模式，包括 standalone、cluster、replication 和 sentinel 模式。通过自定义资源定义（CRD），用户可以通过声明式 API 轻松配置和管理 Redis 集群，极大简化了 Redis 在 Kubernetes 环境中的运维复杂度。

Redis-Operator CRD 核心功能与架构

Redis-Operator 的 CRD 设计遵循 Kubernetes 声明式 API 理念，将 Redis 集群的配置抽象为 Kubernetes 原生资源。其核心优势包括：

• 多模式支持：通过不同 CRD 分别管理 standalone、cluster、replication 和 sentinel 模式
• 声明式配置：使用 YAML 定义 Redis 集群状态，Operator 自动协调实际状态与期望状态
• 自动化运维：内置故障检测、自动恢复、滚动更新等运维能力
• 可扩展性：支持自定义配置、资源限制、存储选项和安全策略

Redis-Operator 架构示意图，展示了 CRD 与控制器的交互流程

核心 CRD 类型与定义

Redis-Operator 提供了四个主要 CRD 类型，分别对应不同的 Redis 部署模式：

1. Redis (Standalone 模式)

用于部署单节点 Redis 实例，定义文件位于config/crd/bases/redis.redis.opstreelabs.in_redis.yaml。核心配置包括：

apiVersion: redis.redis.opstreelabs.in/v1beta2 kind: Redis metadata: name: redis-standalone spec: kubernetesConfig: image: redis:7.0-alpine resources: requests: memory: "256Mi" cpu: "100m" limits: memory: "512Mi" cpu: "500m" storage: volumeClaimTemplate: spec: accessModes: ["ReadWriteOnce"] resources: requests: storage: "1Gi" redisExporter: enabled: true

2. RedisCluster (集群模式)

用于部署 Redis 集群，支持分片和自动负载均衡，定义文件位于config/crd/bases/redis.redis.opstreelabs.in_redisclusters.yaml。核心配置包括：

apiVersion: redis.redis.opstreelabs.in/v1beta2 kind: RedisCluster metadata: name: redis-cluster spec: clusterSize: 3 # 分片数量 clusterVersion: v7 kubernetesConfig: image: redis:7.0-alpine redisFollower: replicas: 1 # 每个分片的副本数 storage: volumeClaimTemplate: spec: accessModes: ["ReadWriteOnce"] resources: requests: storage: "2Gi"

3. RedisReplication (主从复制模式)

用于部署主从复制架构，提供高可用性，定义文件位于config/crd/bases/redis.redis.opstreelabs.in_redisreplications.yaml。

4. RedisSentinel (哨兵模式)

用于部署 Redis Sentinel 集群，提供自动故障转移能力，定义文件位于config/crd/bases/redis.redis.opstreelabs.in_redissentinels.yaml。

CRD 核心配置详解

通用配置项

所有 CRD 共享一些通用配置字段：

• kubernetesConfig: Kubernetes 相关配置，包括镜像、资源限制、服务类型等
• storage: 存储配置，支持 PVC 模板和存储类
• redisConfig: Redis 自定义配置，支持额外的 redis.conf 配置
• redisExporter: Prometheus 监控 exporter 配置
• securityContext: 安全上下文配置，包括用户权限、SELinux 等
• affinity & tolerations: 节点亲和性和污点容忍配置

集群特有配置

RedisCluster 还有一些集群特有的配置：

• clusterSize: 分片数量（1-15）
• clusterVersion: Redis 集群版本
• redisLeader & redisFollower: 主从节点的差异化配置
• ** topologySpreadConstraints**: 拓扑分布约束，控制 Pod 跨节点分布

快速上手：部署 Redis 集群

1. 安装 Redis-Operator

git clone https://gitcode.com/gh_mirrors/red/redis-operator cd redis-operator make deploy

2. 创建 Redis 集群

创建redis-cluster.yaml：

apiVersion: redis.redis.opstreelabs.in/v1beta2 kind: RedisCluster metadata: name: my-redis-cluster namespace: default spec: clusterSize: 3 clusterVersion: v7 kubernetesConfig: image: redis:7.0-alpine imagePullPolicy: IfNotPresent resources: requests: memory: "512Mi" cpu: "200m" limits: memory: "1Gi" cpu: "500m" redisFollower: replicas: 1 storage: keepAfterDelete: false volumeClaimTemplate: spec: accessModes: ["ReadWriteOnce"] resources: requests: storage: "2Gi" storageClassName: standard redisExporter: enabled: true image: oliver006/redis_exporter:v1.44.0

应用配置：

kubectl apply -f redis-cluster.yaml

3. 验证部署

# 查看 Redis 集群资源 kubectl get redisclusters.redis.redis.opstreelabs.in # 查看 Pod kubectl get pods -l app=redis-cluster # 查看服务 kubectl get svc -l app=redis-cluster

高级配置示例

启用 TLS 加密

spec: TLS: secret: secretName: redis-tls-secret ca: "ca.crt" cert: "tls.crt" key: "tls.key"

配置持久化存储

spec: storage: keepAfterDelete: true # 删除 CR 时保留 PVC volumeClaimTemplate: spec: accessModes: ["ReadWriteOnce"] resources: requests: storage: "5Gi" storageClassName: fast # 使用高性能存储类

自定义 Redis 配置

spec: redisConfig: additionalRedisConfig: | maxmemory 1gb maxmemory-policy allkeys-lru appendonly yes save 900 1 save 300 10

监控与运维

Redis-Operator 内置支持 Prometheus 监控，通过配置redisExporter.enabled: true即可暴露监控指标。配合 Grafana 可以实现 Redis 性能可视化：

Redis 监控面板示例，展示关键性能指标

总结

Redis-Operator 通过 CRD 将 Redis 集群管理标准化、自动化，极大降低了 Kubernetes 环境中 Redis 部署和运维的复杂度。其核心优势包括：

• 声明式 API：使用 YAML 定义集群状态，简化配置管理
• 自动化运维：自动处理故障恢复、滚动更新等操作
• 灵活扩展：支持多种部署模式和自定义配置
• 企业级特性：内置 TLS、监控、备份等企业级功能

通过本文介绍的 CRD 配置和使用指南，您可以快速上手 Redis-Operator，在 Kubernetes 集群中部署和管理高可用的 Redis 服务。更多高级配置和最佳实践，请参考项目官方文档。

【免费下载链接】redis-operatorA golang based redis operator that will make/oversee Redis standalone/cluster/replication/sentinel mode setup on top of the Kubernetes.项目地址: https://gitcode.com/gh_mirrors/red/redis-operator