添加集群
ECP 支持通过两种方式添加集群:通过 ECP 一键部署 EMQX 集群(即托管方式)或纳管已有集群。
ECP 推荐通过 ECP 一键部署 EMQX 集群,以便体验更加丰富的集群管理功能,同时享受共享许可证和连接数等高级特性。
下表为由 ECP 托管集群和纳管集群在集群管理方面的功能差异:
功能名称 | ECP 托管集群 | ECP 纳管集群 |
---|---|---|
启停 | ✅ | ❌ |
水平扩展 | ✅ | ❌ |
垂直扩展 | ✅ | ❌ |
修改网络类型 | ✅ | ❌ |
修改连接数 | ✅ | ❌ |
升降级 | ✅ | ❌ |
集群转移 | ✅ | ✅ |
删除 | ✅ | ✅ |
集群日志 | ✅ | ✅ |
ECP 托管集群
- 以系统/组织/项目管理员的身份登录 ECP。在工作台 -> 云端集群页面,在集群列表页点击添加集群。
- 集群类型选择新建集群。
- 按集群命名规则填写集群名称;1-200 个字符,并支持 "-"、"_" 和空格。
- 填写连接数,请注意连接数受许可和集群资源配额限制。
- 选择规格,规格设置在请参考集群资源配额。
- 选择节点数,当前单集群最多支持 7 个节点。
- 选择镜像,镜像可以动态添加,方便用户升级,请参考 EMQX 容器镜像列表和镜像服务信息。
- 最后,点击确认。
新建集群将出现在云端集群的集群列表区域。集群状态为更新中,集群创建完成后,状态将变成运行中,即可投入生产使用。

ECP 纳管现有集群
如果您已经部署了一套或几套 EMQX 集群,也可通过 ECP 的集群纳管功能管理已有集群。
以系统/组织/项目管理员的身份登录 ECP。在工作台 -> 云端集群页面,在集群列表页点击添加集群。
集群类型选择现有集群。
按集群命名规则填写集群名称;1-200 个字符,并支持 空格、"-"、"_"
最后,点击确认。此时集群列表会新增一个纳管的集群。
在集群卡片或集群列表中,点击注册节点,将弹出集群注册引导页。
在注册引导页,选择 CPU 架构,当前支持 AMD64、ARM、ARM64 三种架构;按照注册引导页的提示完成注册。
登录到 EMQX 集群安装的虚机或容器环境,例:登录到命名空间
emqx-69f4249c
中名称为emqx-69f4249c-emqx-ee-0
的容器中;bash# 查看 Pod 名称 $ kubectl -n emqx-69f4249c get pod NAME READY STATUS RESTARTS AGE emqx-69f4249c-emax-ee-0 3/3 Running 0 28d # 进入 Pod $ kubectl -n emqx-69f4249c exec -it emqx-69f4249c-emqx-ee-0 -c emqx -- sh # 下载 EMQX Agent $ sudo curl -L -f --output /usr/local/bin/emqxee-agent https://staging.ecp.mqttce.com/dl/emqx/agents/emqxee-agent -linux-amd64
按顺序执行注册引导页中的命令;
bash# 下载 EMQX Agent sudo curl -L -f --output /usr/local/bin/emqxee-agent https://staging.ecp.mqttce.com/dl/emqx/agents/emqxee-agent-linux-amd64 # 修改 Agent 权限 sudo chmod +x /usr/local/bin/emqxee-agent # 启动 Agent sudo /usr/local/bin/emqxee-agent start # 注册到 ECP sudo /usr/local/bin/emqxee-agent register --url https://staging.ecp.mqttce.com/api --registration-token bf2779e5176446cd8e18fde81d826497
回到 ECP 云端集群页,查看集群列表,可以看到被纳管的 EMQX 集群已被注册到 ECP 中,状态显示为运行中;
集群状态
根据您业务场景的变化,您可对集群进行启停操作。
- 以系统/组织/项目管理员的身份登录 ECP。
- 在目标集群上,点击停止/启动。
此外,EMQX 集群状态除了上一节说到的更新中和运行中,还有如下状态:
状态 | 说明 |
---|---|
创建中 | 新建集群过程的中间状态 |
更新中 | 水平、垂直扩容,修改网络类型,修改连接数,集群升降级 |
启动中 | 点击启动服务 |
运行中 | 集群正常运行状态 |
停止中 | 点击停止服务,或者删除集群后的中间状态 |
已停止 | 停止完成,删除 |
状态同步中 | 水平、垂直扩容,集群升降级,修改网络类型,修改连接数 |
降级运行中 | 集群一个或多个节点不可用, 但集群整体依然可用 |
异常 | 集群最近的一个任务执行失败(可自动恢复),或者集群发生故障或者脏数据(极少出现该状态) |
不存在 | 集群创建任务没有下发成功, |
如果集群状态显示为异常,可以进行尝试修复,如果修复成功,集群状态显示运行中;如果修复失败,请删除集群或联系 EMQ 技术支持。