快速开始
ECP 提供了基于 Kubernetes 快速部署的方式,帮助用户快速搭建 ECP 云边一体化平台。在本章节中,用户可以通过简单的几步操作,快速体验 ECP 的功能和特性。
以超级用户的身份登陆 ECP,并初始化环境配置。
通过 ECP 一键部署 EMQX 集群和边缘服务 Neuron/eKuiper,体验平台的各种服务和功能。
安装 ECP
初始化环境配置
安装完成以后,还要经过以下步骤的初始化环境配置,才能通过 ECP 创建服务。
步骤 | 说明 |
---|---|
配置许可证 | 准备并安装 ECP 许可证授权。 |
配置 Kubernetes 连接 | 配置 ECP 到 Kubernetes 的连接,从而让 ECP 管理、控制和认证 Kubernetes 资源。 |
配置存储类 | 存储类是 Kubernetes 资源类型的一种,ECP 将 Kubernetes 的存储类用作集群和边缘服务的存储资源。 |
EMQX 集群镜像及规格配置 | 配置 EMQX 集群版本,并配置 EMQX 集群在安装、升级时使用底层资源的规格。 |
边缘服务镜像及规格配置 | 配置边缘服务版本,并配置边缘服务在安装、升级时使用底层资源的规格。 |
配置许可证
在使用 ECP 之前,您可先前往 EMQ - 联系我们页面申请一个免费许可证。已经有付费许可证的用户请忽略此步。
- 安装完成 ECP 以后,使用安装时创建的超级管理员登录,切换到系统管理界面,点击左侧菜单许可证管理。
- 点击更新许可证,上传 ECP 许可证;
- 此时,许可证管理页会显示许可证的集群使用数、连接数和边缘服务数的使用限制;
配置 Kubernetes 连接
登录到 Kubernetes master 节点。
在 Kubernetes 命令行工具中,通过以下命令查看
kubeconfig
的默认位置。下载kubeconfig
文件到本地。~/.kube/config
在 ECP 的系统管理界面,点击左侧菜单系统设置 -> 资源配置,点击 Kubernetes 连接设置。
上传
kubeconfig
文件并保存,此时,ECP 已经可以调用 Kubernetes API和资源了。
配置存储类
存储类是云端集群和边缘服务在配置资源规格时必不可少的一步,本节将以配置 EMQX 集群为例介绍存储类的配置方法。
首先,通过命令行登录到 Kubernetes 环境;
通过以下命令查看存储类列表,包含系统自带的存储类或自建的存储类;
kubectl get sc NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE alicloud-disk-ssd diskplugin.csi.alibabacloud.com Delete Immediate true 170d alicloud-disk-topology diskplugin.csi.alibabacloud.com Delete WaitForFirstConsumer true 170d local-path rancher.io/local-path Delete WaitForFirstConsumer false 169d
返回 ECP,选择一个存储类(系统管理 -> 系统设置 -> 资源配置 -> 云端集群配置 -> 集群资源配额)。注意:存储类的名称要和 Kubernetes 存储类列表的名称一致,设置存储大小和是否默认存储类;
保存设置,新建的存储类会立即生效;
EMQX 集群镜像配置
本快速上手教程将以 EMQX 4.4.15( emqx/emqx-ee:4.4.15
) 为例演示如何通过 ECP 安装 EMQX 云端集群。在 ECP 系统管理页,点击系统设置 -> 资源配置 -> 云端集群配置 -> EMQX 容器镜像列表。
在镜像文本框中,输入 emqx/emqx-ee:4.4.15
,并设为默认镜像,随即点击确认完成设置。

EMQX 集群规格配置
本篇将以配置 CPU 为 1 核,内存为 1 Gi,存储为 512 Mi 的规格为例,演示 EMQX 集群规格的配置,具体配置见下图。
有关每个配额配置项的详细解释,见集群资源配额。
边缘服务镜像配置
本快速上手教程将以 eKuiper 1.9.0( lfedge/ekuiper:1.9.0-slim-python
)和 Neuron 2.3.7 (emqx/neuron:2.3.7
) 为例演示如何通过 ECP 安装边缘服务。在 ECP 系统管理页,点击系统设置 -> 资源配置 -> 边缘服务配置 -> 边缘服务容器镜像列表。
- 在 eKuiper 下的镜像文本框中,输入
lfedge/ekuiper:1.9.0-slim-python
,并设为默认镜像,随即点击确认完成设置。 - 在 Neuron 下的镜像文本框中,输入
emqx/neuron:2.3.7
,并设为默认镜像,随即点击确认完成设置。

边缘服务规格配置
本节将分别为 eKuiper 和 Neuron 进行如下规格配置:CPU 为 1 核,内存为 1 Gi,磁盘为 100 Mi,具体配置如下图所示

通过 ECP 创建服务
初始化 ECP 的运行环境之后,本教程将通过创建/管理 ECP 集群和边缘服务,带您体验 ECP 的各项功能。
步骤 | 说明 |
---|---|
创建组织/项目 | ECP 通过组织/项目管理功能实现了企业级多租户管理。通过 ECP 进行云边协同之前,您需要首先完成组织和项目的创建。 |
创建并管理 EMQX 集群 | 体验使用 ECP 创建、管理 EMQX 集群。 |
创建并管理边服务 | 体验使用 ECP 创建、管理边缘服务。 |
创建组织/项目
ECP 是多租户多项目的管理方式,搭建 EMQX 集群、安装 Neuron 和 eKuiper 都需要建立在具体项目上,所以我们首先需要创建组织和项目。
以系统管理员的身份登录 ECP,切换到系统管理界面。
点击左侧菜单栏的组织管理。
在组织管理列表页点击新建组织,在弹出的对话框中,进行如下设定:
- 组织名称填入 EMQ;
- 在左侧的组织成员列选择组织成员,并设置为组织管理员;
- 点击确认保存输入内容;
组织列表内出现新建的组织 EMQ。
随即切换到项目管理页面,重复上述步骤创建项目 ECP。
完成组织和项目的创建后,即可开始通过 ECP 创建和管理云端 EMQX 集群和边缘服务。
创建并管理 EMQX 集群
切换到工作台界面,并切换到刚刚创建的组织 EMQ 和项目 ECP 中;ECP 将默认进入云端集群页面。
在云端集群页面,点击页面右上角的添加集群,并进行如下设置:
- 集群类型选择新建集群
- 输入一个集群名称,如 emqx-test
- 连接数使用默认的 10
- 规格选择默认的 1C2G
- 节点数选择 1
- 使用默认镜像
- 点击确认创建集群。
此时集群列表页将出现刚创建好的集群;等待大概1分钟完成集群初始化,当集群状态显示运行中时,表示集群已经创建完成。
完成集群创建后,您可以体验使用 ECP 快速管理、运维和控制 EMQX 集群,如集群启停、水平和垂直扩展、修改网络类型、修改连接数、一键升级、监控告警和日志等功能,也可以进入 EMQX 集群详情,进入 EMQX 控制台监控和修改 EMQX 的各项配置。 具体内容,见云端集群管理。
创建并管理边缘服务
边缘服务 Neuron 和 eKuiper 的安装方式类似,这里将以安装 Neuron 为例进行说明。切换到工作台界面,并切换到刚刚创建的组织 EMQ 和项目 ECP 中;点击左侧的边缘服务进入边缘服务页。
在边缘服务管理列表页,点击添加边缘服务,在弹出的对话框中进行如下设置
- 添加方式选择批量安装新服务
- 类型选择 Neuron
- 连接方式选择直连
- 名称簇填写 Neuron-test
- 安装数量填写 1
- 规格使用默认
- 使用默认的 Neuron 镜像
- 不开启认证
- 在右侧确认设置的各项数据,点击确认进行安装
ECP 随即将弹出安装进程页,您可在此查看安装过程和结果。
完成边缘服务的安装后,您即可开始通过 ECP 管理和运维边缘服务,包括监控告警、日志等运维服务,批量安装和批量导入服务,使用标签系统进行业务分组,使用配置批量下发配置多个边缘服务实例。 边缘服务的详细功能请参考边缘服务管理。