添加集群 ​

ECP 支持通过两种方式添加集群：通过 ECP 一键部署 EMQX 集群（即托管方式）或纳管已有集群。

ECP 推荐通过 ECP 一键部署 EMQX 集群，以便体验更加丰富的集群管理功能，同时享受共享许可证和连接数等高级特性。

下表为由 ECP 托管集群和纳管集群在集群管理方面的功能差异：

ECP 托管集群 ​

1. 以系统/组织/项目管理员的身份登录 ECP。在工作台 -> 云端集群页面，在集群列表页点击添加集群。
2. 集群类型选择新建集群。
3. 按集群命名规则填写集群名称；1-200 个字符，并支持 "-"、"_" 和空格。
4. 填写连接数，请注意连接数受许可和集群资源配额限制。
5. 选择规格，规格设置在请参考集群资源配额。
6. 选择节点数，当前单集群最多支持 7 个节点。
7. 选择镜像，镜像可以动态添加，方便用户升级，请参考 EMQX 容器镜像列表和镜像服务信息。
8. 最后，点击确认。

新建集群将出现在云端集群的集群列表区域。集群状态为更新中，集群创建完成后，状态将变成运行中，即可投入生产使用。

ECP 纳管现有集群 ​

如果您已经部署了一套或几套 EMQX 集群，也可通过 ECP 的集群纳管功能管理已有集群。

1. 以系统/组织/项目管理员的身份登录 ECP。在工作台 -> 云端集群页面，在集群列表页点击添加集群。

2. 集群类型选择现有集群。

3. 按集群命名规则填写集群名称；1-200 个字符，并支持 空格、"-"、"_"

4. 最后，点击确认。此时集群列表会新增一个纳管的集群。

5. 在集群卡片或集群列表中，点击注册节点，将弹出集群注册引导页。

   

6. 在注册引导页，选择 CPU 架构，当前支持 AMD64、ARM、ARM64 三种架构；按照注册引导页的提示完成注册。

   

7. 登录到 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

8. 按顺序执行注册引导页中的命令；

   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

9. 回到 ECP 云端集群页，查看集群列表，可以看到被纳管的 EMQX 集群已被注册到 ECP 中，状态显示为运行中；

   

集群状态 ​

根据您业务场景的变化，您可对集群进行启停操作。

1. 以系统/组织/项目管理员的身份登录 ECP。
2. 在目标集群上，点击停止/启动。

此外，EMQX 集群状态除了上一节说到的更新中和运行中，还有如下状态：

如果集群状态显示为异常，可以进行尝试修复，如果修复成功，集群状态显示运行中；如果修复失败，请删除集群或联系 EMQ 技术支持。