Kubernetes operator to deploy and manage RabbitMQ clusters. This repository contains a custom controller and custom resource definition (CRD) designed for the lifecyle (creation, upgrade, graceful shutdown) of a RabbitMQ cluster.
Note: this repository is under active development and is provided as beta software. Official support for this software is not provided; if you encounter any issues running this software, please feel free to contribute to the project.
If you have a running Kubernetes cluster and kubectl configured to access it, run the following command to install the operator:
kubectl apply -f https://github.com/rabbitmq/cluster-operator/releases/latest/download/cluster-operator.ymlThen you can deploy a RabbitMQ cluster:
kubectl apply -f https://raw.githubusercontent.com/rabbitmq/cluster-operator/main/docs/examples/hello-world/rabbitmq.yaml
RabbitMQ Cluster Kubernetes Operator is covered by several guides:
- Operator overview
- Deploying an operator
- Deploying a RabbitMQ cluster
- Monitoring the cluster
- Troubleshooting operator deployments
In addition, a number of examples can be found in this repository.
The doc guides are open source. The source can be found in the RabbitMQ website repository
under site/kubernetes.
The operator deploys RabbitMQ 3.8.9 by default, and supports versions from 3.8.8 upwards. The operator requires Kubernetes 1.16 or newer.
RabbitMQ Cluster Kubernetes Operator follows non-strict semver.
The versioning guidelines document contains guidelines on how we implement non-strict semver. The version number MAY or MAY NOT follow the semver rules. Hence, we highly recommend to read the release notes to understand the changes and their potential impact for any release.
This project follows the typical GitHub pull request model. Before starting any work, please either comment on an existing issue, or file a new one.
Please read contribution guidelines if you are interested in contributing to this project.
Licensed under the MPL, same as RabbitMQ server.
Copyright 2020 VMware, Inc. All Rights Reserved.