A Kubernetes Operator for EMQ X Broker and EMQ X Enterprise
The EMQ X Operator provides Kubernetes native deployment and management of EMQ X includes EMQ X Broker and EMQ X Enterprise. The purpose of this project is to simplify and automate the configuration of EMQ X cluster.
The EMQ X Operator includes, but is not limited to, the following features:
-
Kubernetes Custom Resource: Deploy and manage EMQ X Cluster with pre-defined custom resources.
-
Simplified Deployment Configuration: Configure the fundamentals of EMQ X Cluster, including persistence, configuration, license and etc, in a Kubernetes-native way.
For an introduction to the EMQ X Operator, see the get started guide.
The EMQ X Operator requires a Kubernetes cluster of version >=1.20.0
.
A core feature of the EMQ X Operator is to monitor the Kubernetes API server for changes to specific objects and ensure that the running EMQ X deployments match these objects. The Operator acts on the following custom resource definitions (CRDs).
The example of EMQ X Broker see the emqx.yaml and the example of EMQ X Enterprise see the emqx-ee.yaml.
The EMQ X Operator automatically detects changes on any of the above custom resource objects, and ensures that running deployments are kept in sync with the changes.
For more information on get started, see the user guide
- golang environment
- docker (used for creating container images, etc.)
- Kubernetes cluster
Many files (api, config, controller, hack,...) in this repository are auto-generated. Before proposing a pull request:
- Commit your changes.
- Run
make
andmake manifests
- Commit the generated changes.
Check the troubleshooting documentation for common issues and frequently asked questions (FAQ).