热门搜索:
emqx/emqx-operator-controller
emqx
EMQX Operator用于在Kubernetes中创建和管理EMQX集群，提供原生部署和管理能力，简化并自动化EMQX集群的配置、运维与扩展。
下载次数: 0状态：社区镜像维护者：emqx仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
EMQX Operator
访问 emqx.io 获取完整文档、示例和指南。
![codecov]([***]
概述
EMQX Operator提供Kubernetes原生部署和管理能力，支持EMQX（包括EMQX Broker和EMQX Enterprise）。本项目旨在简化和自动化EMQX集群的配置过程。
EMQX Operator的核心功能包括但不限于：
-
简化EMQX部署：通过EMQX自定义资源声明EMQX集群并快速部署。详情请参见快速开始。
-
管理EMQX集群：自动化EMQX的运维操作，包括集群升级、运行时数据持久化、基于EMQX状态更新Kubernetes资源等。详情请参见管理EMQX。
EMQX与EMQX Operator兼容性
EMQX Enterprise
| 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 开源版版本 | 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 |
如何选择Kubernetes版本
EMQX Operator要求Kubernetes集群版本>=1.24。
| Kubernetes 版本 | EMQX Operator 兼容性 | 说明 |
|---|---|---|
| 1.24（含）~ 最新 | 支持所有功能 | |
| 1.22（含）～ 1.23 | 支持，但不支持MixedProtocolLBService | EMQX集群在LoadBalancer类型的Service中只能使用一种协议（如TCP或UDP）。 |
| 低于1.22 | 不支持 | 会出现unknown field "x-kubernetes-validations" in io.k8s.apiextensions-apiserver.pkg.apis.apiextensions.v1.JSONSchemaProps]错误。 |
自定义资源定义（CRDs）
EMQX Operator的核心功能是监控Kubernetes API服务器中特定对象的变更，并确保运行中的EMQX部署与这些对象保持一致。
Operator对以下自定义资源定义（CRDs）生效：
有关EMQX的更多详情，请参见https://github.com/emqx/emqx-operator/blob/main/docs/en_US/reference/v2alpha1-reference.md%E3%80%82
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 |
开发
前提条件
- Golang环境
- docker（用于创建容器镜像等）
- Kubernetes集群
- telepresence
一次性安装Telepresence
shellmake telepresence
连接集群
shell./bin/telepresence connect
贡献
本仓库中的许多文件（API、配置、控制器、hack等）是自动生成的。在提交拉取请求前：
- 提交您的更改。
- 运行
make和make manifests - 提交生成的变更。
故障排除
有关常见问题和常见问题解答（FAQ），请参见故障排除文档。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 emqx-operator-controller 镜像标签
docker pull docker.xuanyuan.run/emqx/emqx-operator-controller:<标签>
DockerHub 原生拉取命令
docker pull emqx/emqx-operator-controller:<标签>
更多 emqx-operator-controller 镜像推荐
library/emqx
Docker 官方镜像
已弃用；这是一款专为物联网（IoT）、工业物联网（IIoT）、联网车辆等场景设计的最具可扩展性的开源MQTT消息代理，具备高效处理大规模设备连接的能力，曾广泛应用于各类智能设备互联与数据传输领域，为海量终端提供稳定可靠的通信支持。
108 次收藏100万+ 次下载
5 天前更新
victoriametrics/operator
victoriametrics
用于在Kubernetes环境中自动化部署、管理和运维Victoria Metrics时序数据库的Operator控制器
1亿+ 次下载
3 天前更新
istio/operator
istio
用于在Kubernetes集群内管理Istio服务网格的操作员，支持自动化部署、配置及生命周期管理。
7 次收藏10亿+ 次下载
1 年前更新
rancher/cis-operator
rancher
暂无描述
500万+ 次下载
3 个月前更新
istio/operator
istio
用于在Kubernetes集群内管理Istio服务网格的操作员，支持自动化部署、配置及生命周期管理。
7 次收藏10亿+ 次下载
1 年前更新
rancher/cis-operator
rancher
暂无描述
500万+ 次下载
3 个月前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"