emqx/emqx-operator-controller访问 emqx.io 获取完整文档、示例和指南。
。本项目旨在简化和自动化EMQX集群的配置过程。
EMQX Operator的核心功能包括但不限于:
简化EMQX部署:通过EMQX自定义资源声明EMQX集群并快速部署。详情请参见快速开始。
管理EMQX集群:自动化EMQX的运维操作,包括集群升级、运行时数据持久化、基于EMQX状态更新Kubernetes资源等。详情请参见管理EMQX。
| EMQX Enterprise 版本 | EMQX Operator 版本 | APIVersion | Kind |
|---|---|---|---|
| 5.6.0(含)~ 最新 | 2.2.24 ~ 最新 | apps.emqx.io/v2beta1 | EMQX |
| 5.1.1(含)~ 最新 | 2.2.0 ~ 最新 | apps.emqx.io/v2beta1 | EMQX |
| 5.0.0(含)~ 5.0.23 | 2.0.0, 2.0.1, 2.0.2, 2.0.3, 2.1.0, 2.1.1 | apps.emqx.io/v2alpha1 | EMQX |
| 4.4.14(含)或更高4.4.x | 2.1.0, 2.1.1 | apps.emqx.io/v1beta4 | EmqxEnterprise |
| 4.4.8(含)~ 4.4.14 | 1.2.6, 1.2.7, 1.2.8, 2.0.0, 2.0.1, 2.0.2, 2.0.3 | apps.emqx.io/v1beta3 | EmqxEnterprise |
| 4.4.6(含)~ 4.4.8 | 1.2.5 | apps.emqx.io/v1beta3 | EmqxEnterprise |
| 4.3.x(含)~ 4.4 | 1.2.1, 1.2.2, 1.2.3 | apps.emqx.io/v1beta3 | EmqxEnterprise |
| EMQX 开源版版本 | EMQX Operator 版本 | APIVersion | Kind |
|---|---|---|---|
| 5.6.0(含)~ 最新 | 2.2.24 ~ 最新 | apps.emqx.io/v2beta1 | EMQX |
| 5.1.1(含)~ 最新 | 2.2.0 ~ 最新 | apps.emqx.io/v2beta1 | EMQX |
| 5.0.14(含)~ 5.0.23 | 2.1.0, 2.1.1 | apps.emqx.io/v2alpha1 | EMQX |
| 5.0.8(含)~ 5.0.14 | 2.0.2 | apps.emqx.io/v2alpha1 | EMQX |
| 5.0.6(含)~ 5.0.8 | 2.0.0, 2.0.1, 2.0.3 | apps.emqx.io/v2alpha1 | EMQX |
| 4.4.14或更高4.4.x | 2.1.0, 2.1.1 | apps.emqx.io/v1beta4 | EmqxBroker |
| 4.4.6(含)~ 4.4.8 | 1.2.5 | apps.emqx.io/v1beta3 | EmqxBroker |
| 4.4.8(含)~ 4.4.14 | 1.2.6, 1.2.7, 1.2.8, 2.0.0, 2.0.1, 2.0.2, 2.0.3 | apps.emqx.io/v1beta3 | EmqxBroker |
| 4.3.x(含)~ 4.4 | 1.2.1, 1.2.2, 1.2.3 | apps.emqx.io/v1beta3 | EmqxBroker |
EMQX Operator要求Kubernetes集群版本>=1.24。
| Kubernetes 版本 | EMQX Operator 兼容性 | 说明 |
|---|---|---|
| 1.24(含)~ 最新 | 支持所有功能 | |
| 1.22(含)~ 1.23 | 支持,但不支持MixedProtocolLBService | EMQX集群在Load***类型的Service中只能使用一种协议(如TCP或UDP)。 |
| 低于1.22 | 不支持 | 会出现unknown field "x-kubernetes-validations" in io.k8s.apiextensions-apiserver.pkg.apis.apiextensions.v1.JSONSchemaProps]错误。 |
EMQX Operator的核心功能是监控Kubernetes API服务器中特定对象的变更,并确保运行中的EMQX部署与这些对象保持一致。
Operator对以下自定义资源定义(CRDs)生效:
有关EMQX的更多详情,请参见参考文档。
EMQX Operator会自动检测上述任何自定义资源对象的变更,并确保运行中的部署与变更保持同步。
如需快速上手,请参见快速开始文档。
| 公有云平台 | 部署指南 |
|---|---|
| AWS | 在Amazon Elastic Kubernetes Service上部署EMQX |
| Azure | 在Azure Kubernetes Service上部署EMQX |
| Google Cloud | 在Google Cloud GKE上部署EMQX |
| 阿里云 | 在阿里云ACK上部署EMQX |
| 华为云 | 在华为云CCE上部署EMQX |
| 腾讯云 | 在腾讯云TKE上部署EMQX |
shellmake telepresence
shell./bin/telepresence connect
本仓库中的许多文件(API、配置、控制器、hack等)是自动生成的。在提交拉取请求前:
make和make manifests有关常见问题和常见问题解答(FAQ),请参见故障排除文档。


manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务