bitnamicharts/rabbitmq-cluster-operator

Bitnami RabbitMQ Cluster Operator 软件包

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

https://github.com/rabbitmq/cluster-operator

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

快速入门

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

希望在生产环境中使用RabbitMQ Cluster Operator？请尝试https://bitnami.com/enterprise%EF%BC%8C%E5%8D%B3Bitnami%E7%9B%AE%E5%BD%95%E7%9A%84%E5%95%86%E4%B8%9A%E7%89%88%E6%9C%AC%E3%80%82

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

自2025年8月28日起，Bitnami将升级其公共目录，在新的https://news.broadcom.com/app-dev/broadcom-introduces-bitnami-secure-images-for-production-ready-containerized-applications%E4%B8%8B%E6%8F%90%E4%BE%9B%E7%B2%BE%E9%80%89%E7%9A%84%E5%BC%BA%E5%8C%96%E3%80%81%E5%AE%89%E5%85%A8%E8%81%9A%E7%84%A6%E9%95%9C%E5%83%8F%E9%9B%86%E3%80%82%E4%BD%9C%E4%B8%BA%E6%AD%A4%E6%AC%A1%E8%BF%87%E6%B8%A1%E7%9A%84%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A

• 首次向社区用户提供流行容器镜像的安全优化版本访问权限。
• 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用户的安全态势。更多详情，请访问https://github.com/bitnami/containers/issues/83267%E3%80%82

简介

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

本Chart使用[***]

前提条件

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

安装Chart

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

console
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后集群中部署的对象：

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

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

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

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

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

text
  +--------------------+
  |                    |      +---------------+
  |  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部分。有关这些预设的详细信息，请参见https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15%E3%80%82%E4%BD%86%E5%9C%A8%E7%94%9F%E4%BA%A7%E5%B7%A5%E4%BD%9C%E8%B4%9F%E8%BD%BD%E4%B8%AD%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%60resourcesPreset%60%EF%BC%8C%E5%9B%A0%E4%B8%BA%E5%AE%83%E5%8F%AF%E8%83%BD%E6%97%A0%E6%B3%95%E5%AE%8C%E5%85%A8%E9%80%82%E5%BA%94%E6%82%A8%E7%9A%84%E5%85%B7%E4%BD%93%E9%9C%80%E6%B1%82%E3%80%82%E6%9C%89%E5%85%B3%E5%AE%B9%E5%99%A8%E8%B5%84%E6%BA%90%E7%AE%A1%E7%90%86%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/%E3%80%82

备份和恢复

要在Kubernetes上备份和恢复Helm Chart部署，需使用https://velero.io/%EF%BC%88Kubernetes%E5%A4%87%E4%BB%BD/%E6%81%A2%E5%A4%8D%E5%B7%A5%E5%85%B7%EF%BC%89%E5%A4%87%E4%BB%BD%E6%BA%90%E9%83%A8%E7%BD%B2%E7%9A%84%E6%8C%81%E4%B9%85%E5%8D%B7%EF%BC%8C%E5%B9%B6%E5%B0%86%E5%85%B6%E9%99%84%E5%8A%A0%E5%88%B0%E6%96%B0%E9%83%A8%E7%BD%B2%E3%80%82%E6%9C%89%E5%85%B3%E4%BD%BF%E7%94%A8Velero%E7%9A%84%E8%AF%B4%E6%98%8E%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81https://techdocs.broadcom.com/us/en/vmware-tanzu/application-catalog/tanzu-application-catalog/services/tac-doc/apps-tutorials-backup-restore-deployments-velero-index.html%E3%80%82

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。安装https://github.com/bitnami/charts/tree/main/bitnami/prometheus%E6%88%96https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%8C%E5%8F%AF%E8%BD%BB%E6%9D%BE%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E9%83%A8%E7%BD%B2%E5%8F%AF%E7%94%A8%E7%9A%84Prometheus%E3%80%82

与Prometheus Operator集成

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

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

安装https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%BF%85%E8%A6%81%E7%9A%84CRD%E5%92%8CPrometheus Operator。

https://techdocs.broadcom.com/us/en/vmware-tanzu/application-catalog/tanzu-application-catalog/services/tac-doc/apps-tutorials-understand-rolling-tags-containers-index.html

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

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

额外环境变量

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

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

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

边车容器（Sidecars）

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

yaml
sidecars:
- name: your-image-name
  image: docker.xuanyuan.run/your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

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

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

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

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

yaml
initContainers:
  - name: your-image-name
    image: docker.xuanyuan.run/your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

了解更多关于https://kubernetes.io/docs/concepts/workloads/pods/%E5%92%8Chttps://kubernetes.io/docs/concepts/workloads/pods/init-containers/%E7%9A%84%E4%BF%A1%E6%81%AF%E3%80%82

Pod亲和性

本Chart允许使用affinity参数设置自定义亲和性。有关Pod亲和性的更多信息，请参见https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity%E3%80%82

作为替代方案，可使用https://github.com/bitnami/charts/tree/main/bitnami/common#affinities chart中提供的Pod亲和性、Pod反亲和性和节点亲和性预设配置。为此，设置podAffinityPreset、podAntiAffinityPreset或nodeAffinityPreset参数。

部署额外资源

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

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

yaml
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和参数列表请参见https://github.com/bitnami/charts/blob/main/bitnami/rabbitmq-cluster-operator/README.md