Bitnami RabbitMQ Cluster Operator 软件包

RabbitMQ Cluster Kubernetes Operator可自动化在Kubernetes上运行的RabbitMQ集群的配置、管理和运维操作。

RabbitMQ Cluster Operator 概述

商标声明：本软件列表由Bitnami打包。产品中提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

快速入门

helm install my-release oci://registry-1.docker.io/bitnamicharts/rabbitmq-cluster-operator

希望在生产环境中使用RabbitMQ Cluster Operator？请尝试VMware Tanzu Application Catalog，即Bitnami目录的商业版本。

⚠️ 重要通知：Bitnami目录即将发生的变更

自2025年8月28日起，Bitnami将升级其公共目录，在新的Bitnami Secure Images计划下提供精选的强化、安全聚焦镜像集。作为此次过渡的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本访问权限。
• Bitnami将开始在免费层中弃用对非强化、基于Debian的软件镜像的支持，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像，这些镜像仅以“latest”标签发布，适用于开发目的。
• 从8月28日开始，在两周内，所有现有容器镜像（包括旧版本或特定版本标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用Bitnami Secure Images，包括强化容器、更小的攻击面、CVE透明度（通过VEX/KEV）、SBOM以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提升所有Bitnami用户的安全态势。更多详情，请访问Bitnami Secure Images公告。

简介

Bitnami Helm Chart经过精心设计、积极维护，是在Kubernetes集群上部署容器的最快、最简单方式，可直接用于生产工作负载。

本Chart使用Helm包管理器在Kubernetes集群中引导部署RabbitMQ Cluster Operator。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持PV供应器

安装Chart

要使用发布名称my-release安装Chart：

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/rabbitmq-cluster-operator

注意：需将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm Chart仓库和存储库的引用。例如，对于Bitnami，需使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

该命令将RabbitMQ Cluster Kubernetes Operator部署到Kubernetes集群的默认配置中。参数部分列出了安装过程中可配置的参数。

提示：使用helm list列出所有发布

Bitnami RabbitMQ chart与Bitnami RabbitMQ Operator chart的区别

在Bitnami目录中，我们提供bitnami/rabbitmq和bitnami/rabbitmq-operator两种Chart。每种解决方案适用于不同需求和场景。

bitnami/rabbitmq chart使用Kubernetes StatefulSet对象（以及Service、PVC、ConfigMap等）部署单个RabbitMQ实例。下图显示执行helm install后集群中部署的对象：

                    +--------------+             +-----+
                    |              |             |     |
 Service            |   RabbitMQ   +<------------+ PVC |
<-------------------+              |             |     |
                    |  StatefulSet |             +-----+
                    |              |
                    +-----------+--+
                                ^                +------------+
                                |                |            |
                                +----------------+ Configmaps |
                                                 | Secrets    |
                                                 +------------+

其生命周期通过Helm管理，在RabbitMQ容器级别，自动执行持久化管理、基于环境变量的配置和插件初始化。StatefulSet不需要任何具有特殊RBAC权限的ServiceAccount，因此该解决方案更适合权限受限的Kubernetes环境。

bitnami/rabbitmq-operator chart使用Kubernetes Deployment部署RabbitMQ Operator。下图显示执行helm install后部署的RabbitMQ Operator：

+--------------------+
|                    |      +---------------+
|  RabbitMQ Operator |      |               |
|                    |      |     RBAC      |
|     Deployment     |      | Privileges    |
+-------+------------+      +-------+-------+
        ^                           |
        |   +-----------------+     |
        +---+ Service Account +<----+
            +-----------------+

Operator将通过以下对象扩展Kubernetes API：RabbitmqCluster。此后，用户可部署此类对象，已部署的Operator将负责部署运行RabbitMQ实例所需的所有StatefulSet、ConfigMap和Service。其生命周期通过kubectl管理RabbitmqCluster对象。下图显示使用kubectl部署RabbitmqCluster对象后部署的对象：

  +--------------------+
  |                    |      +---------------+
  |  RabbitMQ Operator |      |               |
  |                    |      |     RBAC      |
  |     Deployment     |      | Privileges    |
  +-------+------------+      +-------+-------+
  |     ^                           |
  |     |   +-----------------+     |
  |     +---+ Service Account +<----+
  |         +-----------------+
  |
  |
  |
  |
  |    -------------------------------------------------------------------------
  |    |                                                                       |
  |    |                        +--------------+             +-----+           |
  |    |                        |              |             |     |           |
  |--->|     Service            |   RabbitMQ   +<------------+ PVC |           |
       |    <-------------------+              |             |     |           |
       |                        |  StatefulSet |             +-----+           |
       |                        |              |                               |
       |                        +-----------+--+                               |
       |                                    ^                +------------+    |
       |                                    |                |            |    |
       |                                    +----------------+ Configmaps |    |
       |                                                     | Secrets    |    |
       |                                                     +------------+    |
       |                                                                       |
       |                                                                       |
       -------------------------------------------------------------------------

与bitnami/rabbitmq chart相比，该解决方案可更轻松地部署多个RabbitMQ实例。由于Operator自动部署RabbitMQ实例，RabbitMQ Operator Pod需要具有创建和销毁多个Kubernetes对象权限的ServiceAccount。这在具有严格基于角色访问策略的Kubernetes集群中可能存在问题。

配置和安装详情

资源请求和限制

Bitnami Chart允许为Chart部署中的所有容器设置资源请求和限制，这些配置位于resources值中（参见参数表）。为生产工作负载设置请求至关重要，且应根据具体用例调整。

为简化此过程，Chart包含resourcesPreset值，可根据不同预设自动设置resources部分。有关这些预设的详细信息，请参见bitnami/common chart。但在生产工作负载中，不建议使用resourcesPreset，因为它可能无法完全适应您的具体需求。有关容器资源管理的更多信息，请参见Kubernetes官方文档。

备份和恢复

要在Kubernetes上备份和恢复Helm Chart部署，需使用Velero（Kubernetes备份/恢复工具）备份源部署的持久卷，并将其附加到新部署。有关使用Velero的说明，请参见本指南。

Prometheus指标

通过将clusterOperator和msgTopologyOperator部分下的*.metrics.enabled设置为true，可将本Chart与Prometheus集成。这将在容器中公开RabbitMQ Cluster Operator和RabbitMQ Messaging Topology Operator的原生Prometheus端口，并创建可在*.metrics.service（位于clusterOperator和msgTopologyOperator部分下）中配置的不同metrics服务。这些服务还将包含必要的注解，以便被Prometheus自动抓取。

Prometheus要求

要使集成正常工作，需安装Prometheus或Prometheus Operator。安装Bitnami Prometheus helm chart或Bitnami Kube Prometheus helm chart，可轻松在集群中部署可用的Prometheus。

与Prometheus Operator集成

Chart可部署ServiceMonitor对象以与Prometheus Operator集成。为此，需将clusterOperator和msgTopologyOperator部分下的*.metrics.serviceMonitor.enabled设置为true。确保集群中已安装Prometheus Operator CustomResourceDefinitions，否则将失败并显示以下错误：

no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

安装Bitnami Kube Prometheus helm chart以获取必要的CRD和Prometheus Operator。

滚动标签与不可变标签

强烈建议在生产环境中使用不可变标签。这可确保如果同一标签使用不同镜像更新，部署不会自动更改。

如果主容器有新版本、重大变更或严重漏洞，Bitnami将发布新Chart以更新其容器。

额外环境变量

如需添加额外环境变量（用于高级操作，如自定义初始化脚本），可使用extraEnvVars属性。

rabbitmq-cluster-operator:
  extraEnvVars:
    - name: LOG_LEVEL
      value: error

或者，可使用包含环境变量的ConfigMap或Secret。为此，使用extraEnvVarsCM或extraEnvVarsSecret值。

边车容器（Sidecars）

如需在rabbitmq-cluster-operator所在的同一Pod中添加额外容器（如额外指标或日志导出器），可使用sidecars参数定义。

sidecars:
- name: your-image-name
  image: your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

如果这些边车容器导出额外端口，可使用service.extraPorts参数（如可用）添加额外端口定义，如下例所示：

service:
  extraPorts:
  - name: extraPort
    port: 11311
    targetPort: 11311

注意：此Helm Chart已包含Prometheus导出器的边车容器（如适用）。可在部署时添加--enable-metrics=true参数激活这些容器。因此，sidecars参数仅应用于添加额外边车容器。

如需在同一Pod中添加额外初始化容器，可使用initContainers参数定义。示例如下：

initContainers:
  - name: your-image-name
    image: your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

了解更多关于边车容器和初始化容器的信息。

Pod亲和性

本Chart允许使用affinity参数设置自定义亲和性。有关Pod亲和性的更多信息，请参见Kubernetes文档。

作为替代方案，可使用bitnami/common chart中提供的Pod亲和性、Pod反亲和性和节点亲和性预设配置。为此，设置podAffinityPreset、podAntiAffinityPreset或nodeAffinityPreset参数。

部署额外资源

如需部署额外对象（如自定义RabbitmqCluster对象），Chart允许使用extraDeploy参数添加其他对象的完整规范。

例如，要部署自定义RabbitmqCluster定义，可使用以下值安装RabbitMQ Cluster Operator：

extraDeploy:
  - apiVersion: rabbitmq.com/v1beta1
    kind: RabbitmqCluster
    metadata:
      name: rabbitmq-custom-configuration
    spec:
      replicas: 1
      rabbitmq:
        additionalConfig: |
          log.console.level = debug

参数

全局参数

通用参数

RabbitMQ Cluster Operator参数

注意：本Chart的README因超出DockerHub 25000字符限制已被截断。完整README和参数列表请参见[***]