rabbitmqoperator/cluster-operator

RabbitMQ Cluster Operator 镜像文档

概述

RabbitMQ Cluster Operator 镜像为官方提供的 Kubernetes Operator 实现，旨在简化 Kubernetes 环境中 RabbitMQ 集群的部署、运维与生命周期管理。通过自定义资源定义（CRD）和控制器，该镜像可自动化处理 RabbitMQ 集群的创建、扩展、升级、故障恢复等操作，适用于需要在容器编排平台中运行高可用消息队列服务的场景。

核心功能与特性

集群生命周期管理

• 自动化创建、删除 RabbitMQ 集群
• 支持集群平滑升级（版本更新、配置变更）
• 弹性扩缩容（通过调整副本数实现节点水平扩展）

高可用与可靠性

• 自动检测并恢复故障节点
• 支持持久化存储配置，确保消息数据不丢失
• 内置集群发现机制，无需手动配置节点间通信

配置与安全管理

• 通过 CRD 自定义集群参数（资源限制、网络配置、用户认证等）
• 支持 TLS 加密通信（节点间、客户端连接）
• 集成 Kubernetes RBAC 权限控制

监控与可观测性

• 暴露 Prometheus 指标接口，支持监控集成
• 提供集群状态、健康检查及事件记录

使用场景与适用范围

• 微服务架构中需要可靠消息传递的业务场景
• 基于 Kubernetes 的云原生应用消息队列基础设施
• 需自动化运维大规模 RabbitMQ 集群的企业级环境
• 对消息队列服务可用性、可扩展性有高要求的系统

使用方法与配置说明

前提条件

• Kubernetes 集群版本 ≥ 1.19
• 集群已配置 kubectl 命令行工具
• 具备集群管理员权限（用于部署 CRD 和控制器）

部署步骤

1. 安装 CRD 与 Operator

通过官方 manifest 部署自定义资源定义及 Operator 控制器：

bash
kubectl apply -f https://github.com/rabbitmq/cluster-operator/releases/latest/download/cluster-operator.yml

2. 创建 RabbitMQ 集群

1. 定义集群配置文件
   创建 RabbitMQCluster 自定义资源文件（示例：rabbitmq-cluster.yaml）：

yaml
apiVersion: rabbitmq.com/v1beta1
kind: RabbitMQCluster
metadata:
  name: my-rabbitmq-cluster
spec:
  replicas: 3  # 集群节点数量
  resources:
    requests:
      cpu: 500m
      memory: 1Gi
    limits:
      cpu: 1000m
      memory: 2Gi
  service:
    type: ClusterIP  # 服务暴露类型（可选 NodePort/LoadBalancer）
  rabbitmq:
    version: "3.12.0"  # RabbitMQ 版本
  persistence:
    storageClassName: "standard"  # 持久化存储类
    size: "10Gi"  # 存储容量

2. 部署集群

bash
kubectl apply -f rabbitmq-cluster.yaml

3. 验证部署状态

bash
# 查看 RabbitMQ 集群自定义资源
kubectl get rabbitmqclusters

# 查看集群 Pod
kubectl get pods -l app.kubernetes.io/name=my-rabbitmq-cluster

# 查看集群服务
kubectl get services my-rabbitmq-cluster

核心配置参数说明

通过 RabbitMQCluster 资源的 spec 字段可配置集群核心参数，主要包括：

注意事项

• 生产环境需启用持久化存储（spec.persistence）以防止数据丢失
• 集群升级前建议通过 kubectl exec 进入节点执行数据备份
• 调整副本数（扩缩容）时，控制器会自动平衡集群数据分片
• 监控可通过 Prometheus 抓取 http://<pod-ip>:15692/metrics 接口实现