
# 边缘节点
#### 概述
边缘节点是一组软件产品，包含云服务、边缘运行时软件、边缘模块应用，将云端能力快速拓展至边缘，提供数据采集、低时延自治、云边协同、边缘计算等能力。通过边缘节点功能，您可以将与网络隔离的服务封装成连接器部署在边缘节点上，从而解决不同网络之间的服务转发。同时，服务会自动部署集成工作台边端请求代理应用，通过此功能，可以将云端请求转发到边端应用，用户可以通过集成工作台进行边缘节点管理。
#### 前提条件
- 准备边缘节点硬件，边缘节点硬件需要满足CPU架构为x86_64。
- 在边缘节点硬件（华为ecs云服务器或者能联网的linux设备）上安装docker，安装docker参考[安装docker官方教程](https://docs.docker.com/engine/install/)。
- 已开通专业版套餐。
- IMC用户。
- 白名单用户。
 
#### 注册边缘节点
1. 在开天集成工作台界面中，选择左侧导航栏中的"连接器 \> 边缘节点"，单击"注册节点"。
2. 配置节点规格，具体参数说明如[表1]所示，配置完成后，单击"下一步"。
   
    表1参数说明 
   | 参数   | 说明                                                 |
   |:---|:---|
   | 节点名称 | 填写边缘节点的名称，根据规划自定义。建议您按照一定的命名规则填写边缘节点名称，方便您快速识别和查找。 |
   | 网关类型 | 网关设备类型（目前唯一选择"other"）。                             |
   | 节点ID | 输入自定义边缘节点ID。                                       |
   | 验证码  | 输入自定义验证码。验证码，执行安装边缘软件命令时与云端通讯的凭证。                  |
      
   
   
3. 配置节点数据，具体参数说明如[表2]所示，配置完成后，单击"立即创建"。
   
    表2参数说明 
   | 参数        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   |:---|:---|
   | 节点数据存储根目录 | 节点数据存储根目录。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 节点配置根目录   | 节点配置存储根目录。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 节点日志根目录   | 节点日志存储根目录。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 日志配置      | 系统日志：边缘节点上已部署的系统应用产生的日志。 应用日志：边缘节点上已部署的用户定义应用所产生的日志。 - 云端日志级别：on表示上传日志至云端，off表示不上传日志。  - 日志文件大小：日志文件大小限制，单位MB，默认50，取值范围10-1000。某个日志文件如果达到大小限制，则会将文件转储保存至日志目录下。  - 滚动日志周期：日志转储周期，可选项：daily，weekly，monthly，yearly。某个日志文件如果达到转储周期，则会将文件转储保存至日志目录下。日志文件大小和滚动日志周期是同时生效的，满足任何一个条件都会进行日志转储。  - 滚动日志数量：日志文件转储个数，默认5，取值范围1-10。边缘节点保存的转储日志数量如果达到限制，则会删除最旧的那个转储文件。   |
   | 数据加密      | 据您的需要选择数据是否加密： - 加密：边侧本地数据库加密存储，明文上报给云端。  - 不加密：边侧本地数据库明文存储，明文上报给云端。                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   | 存储周期      | 选择存储天数0\~7天，默认为0。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
      
   
   
4. 在弹出对话框中，配置部署边缘软件信息，具体参数说明如[表3]所示。
   
    表3参数说明 
   | 参数     | 说明              |
   |:---|:---|
   | 支持架构   | 目前唯一选项"x86_64"。 |
   | 输入安装目录 | 边缘节点的安装目录。      |
      
   
   
5. 配置完成后，单击"返回节点列表"。 
   ![](https://support.huaweicloud.com/usermanual-mssi/public_sys-resources/note_3.0-zh-cn.png)
   边缘节点列表上方会自动显示资产统计的实时情况，包含边缘节点总数、待安装、已安装、在线、离线、冻结、删除中的数据统计。
   
   
 
#### 安装边缘节点
1. 在边缘节点列表，选择您需要安装的节点，在"操作"列单击"安装"，弹出如[图1]所示的提示信息。
   
   图1安装提示   
   ![](https://support.huaweicloud.com/usermanual-mssi/zh-cn_image_0000001852307472.png "点击放大")
   ![](https://support.huaweicloud.com/usermanual-mssi/public_sys-resources/note_3.0-zh-cn.png)
   安装命令30分钟内有效，如果超出时间，请重新获取安装命令。
   
   
2. 选择边缘节点设备类型，并设置安装目录，然后单击![](https://support.huaweicloud.com/usermanual-mssi/zh-cn_image_0000001852310452.png)复制安装命令。
   
   ![](https://support.huaweicloud.com/usermanual-mssi/public_sys-resources/note_3.0-zh-cn.png)
   请选择支持架构，输入安装目录，并复制安装命令，然后到边缘节点设备上执行命令，完成边缘软件部署。
   
   
3. 使用SSH工具以root用户登录边缘节点服务器的shell控制台，执行安装命令。 
   图2执行安装   
   ![](https://support.huaweicloud.com/usermanual-mssi/zh-cn_image_0000001361768721.png "点击放大")
   图3安装命令执行成功   
   ![](https://support.huaweicloud.com/usermanual-mssi/zh-cn_image_0000001309048512.png "点击放大")
   
   
4. 单击"我知道了"，等待边缘节点的状态变为在线（安装完成后约等待半分钟），表示该节点已安装并连接成功。
 
#### 更多操作
边缘节点注册完成后，您可以执行如[表4]的操作。
 表4相关操作 
| 操作     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|
| 删除边缘节点 | - 删除节点会同步在边缘创建的节点下部署的应用、模块、函数、证书。删除操作无法恢复，请谨慎操作。  - 如果确认删除，请确保您已完成节点删除前的以下必要步骤： 1. 卸载节点上的边缘软件。卸载前请先做好备份工作。  2. 以root用户登录边缘节点，执行如下命令删除已纳管的边缘节点上的软件和配置文件。 ``` sh /opt/IoTEdge-Installer/uninstall.sh ```   3. 在连接列表中，单击"操作"列的"删除"。     |
   
#### 边缘应用管理
应用管理是MSSI边缘服务提供的边缘应用管理能力，可以帮助您标准化地管理边缘端应用的版本、配置等。
1. 在开天集成工作台界面中，选择左侧导航栏中的"连接器 \> 边缘节点"，选择"应用模块"页签。
2. 查看边缘节点应用的相关信息，具体节点应用信息如[表5]所示。
   
   ![](https://support.huaweicloud.com/usermanual-mssi/public_sys-resources/note_3.0-zh-cn.png)
   - mssi_edge，该应用节点是系统的业务应用节点，单击节点名称进入后，在左侧可以看到该节点的所有版本列表，最上面的版本为节点发布的最新版本。 单击右上方的"升级实例"，勾选该节点，单击"确定"。应用节点升级后，用户可以根据实际需要选择升级最新版本的应用节点。
     
   
   - 单击右上方的"部署实例"，如果该应用节点没有部署过，可以部署该应用节点。如果已经部署过，可以查看该应用实例的部署信息，包含节点状态、节点名称、节点IP、节点类型，仅可以查询与此应用版本支持的架构相同的节点。
    
    表5参数说明 
   | 参数     | 说明                                                                                                              |
   |:---|:---|
   | 节点名称   | 边缘应用节点名称。                                                                                                       |
   | 应用类型   | 边缘应用的类型。 说明： 除了服务预置的系统必选/可选的边缘软件，您还可以添加自定义的应用类型。 |
   | 功能类型   | 边缘应用的功能类型。                                                                                                      |
   | 最新发布版本 | 边缘应用的最新发布版本。                                                                                                    |
   | 描述     | 边缘应用的描述。                                                                                                        |
   | 创建时间   | 边缘应用的创建时间。                                                                                                      |
      
   边缘应用发布后，您就可以将其部署到边缘节点。MSSI边缘服务支持应用版本管理。部署边缘应用的具体操作如下：
   
   
3. 选择"边缘节点"页签。
4. 单击已注册并完成安装的节点名称。 
   ![](https://support.huaweicloud.com/usermanual-mssi/public_sys-resources/note_3.0-zh-cn.png)
   如果仅注册了边缘节点，并未进行安装，在部署边缘应用时，系统会自动提示"该边缘节点尚未运行"。请先完成边缘节点的安装，再部署边缘应用。
   
   
5. 在"节点概览"页签查看该节点的详细信息。
6. 选择"应用模块"页签部署边缘应用节点。 
   ![](https://support.huaweicloud.com/usermanual-mssi/public_sys-resources/note_3.0-zh-cn.png)
   sys_edge_hub、sys_edge_agent、user_mssi_edge和sys_edge_apigw，这四个应用模块ID是系统安装完边缘节点后自动进行安装的，且应用状态不能停止，否则会导致系统功能异常。
   1. 单击"部署应用"。
   
   2. 选择边缘应用的名称。
   
   3. 选择边缘应用的版本。此处可以看到多个版本信息，建议选择最新的发布版本。
   
   4. 设置"模块名称"。
   
   5. 单击"确定"。
   
   6. 启用刚部署的边缘应用实例。单击"操作"列的"启用"按钮，在弹出的提示框中，单击"确定"。
   
   7. （可选）升级边缘应用。单击"操作"列的"升级"按钮，在弹出的提示框中，选择边缘应用的最新发布版本，单击"确定"。
   
   8. （可选）停止边缘应用。单击"操作"列的"停止"按钮，在弹出的提示框中，单击"确定"。
   
   
   
   
7. 选择"数据配置"页签查看数据存储路径。
 
