# 创建边缘节点 #### 前提条件 - 已注册[华为云](https://www.huaweicloud.com/)账号，且已完成实名认证。 - 已开通[IoT边缘服务](https://www.huaweicloud.com/product/iotedge.html)和[IoTDA设备接入服务](https://www.huaweicloud.com/product/iothub.html)。 - 在创建边缘节点前，检查配置要符合[硬件规格](https://support.huaweicloud.com/productdesc-iotedge/iotedge_01_0009.html)要求，如磁盘、内存和docker版本，切换root用户执行安装命令。 #### 注册专业版节点 1. 访问[IoT边缘](https://www.huaweicloud.com/product/iotedge.html)，单击"管理控制台"进入IoT边缘控制台。 2. 选择左侧导航栏"边缘节点 \> 节点管理"单击右上角"注册节点"。 3. 根据页面提示填写参数，勾选右下角"《华为云服务等级协议》"单击"下一步"配置节点数据。 图1专业版 ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001898877844.png "点击放大") 表1节点规格参数说明 | 参数名称 | 参数说明 | |:---|:---| | 节点类型 | 选择"专业版"。 | | 部署类型 | 选择"Docker"。 | | AI加速卡 | - 未搭载（默认）：边缘节点未使用AI加速卡时选择。 - 昇腾AI加速卡：支持昇腾AI加速设备，边缘节点的服务器搭载相关昇腾AI加速设备时选择。 | | 昇腾驱动地址 | 可选，AI加速卡选择昇腾AI加速卡时需要保证安装边缘节点的服务器上已经安装昇腾设备驱动，并根据前端提示填入驱动地址。若该值为空，默认填入**"** Atlas 300**"**驱动默认安装地址： /usr/local/Ascend/driver/lib64/。 | | 节点名称 | 自定义节点名称，如"test"。 说明： 节点名称可以在："节点概览"-"基本信息"中编辑修改。 | | 网关类型 | 默认选择 "other"即可（"yuzhen_x86"只在某些特殊网关盒子场景使用）。 | | 节点ID | 自定义（可选填写）。只允许中文，英文字母、数字、中划线（-），下划线（_），最小长度1，最大长度64。 说明： 边缘节点ID自定义(不输入默认生成)。 | | 验证码 | 输入自定义验证码（可选填写）。验证码，执行安装边缘软件命令时与云端通讯的凭证。 | | 设备归属实例 | 选择默认归属实例。 | | 设备归属资源空间 | 选择默认资源空间，或为本实验单独新建一个资源空间，如edge。 | | IoTDA南向接入地址 | 选择网关归属的IoTDA实例的南向设备mqtt接入地址，也可以选择自定义的南向接入地址，支持"ip:端口"或"域名:端口"形式。 | | 鉴权方式 | 密钥：默认生成。 X.509证书：请参考：[基于MQTT.fx的X.509证书接入指导](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0077.html)。 警告： 鉴权方式为"密钥"的节点，请勿在IoTDA界面重置节点的密钥，重置密钥会导致网关与IoTDA通信异常，且不可恢复。 | | 指纹 | 证书文件生成的字符串（可选填写）。只能为40位十六进制字符串或64位六进制字符串。 | | 本地路径 | 输入证书文件和密钥文件在设备上的存储路径，只允许字母、数字、下划线（_）和斜线（/），以/开头并且以.pem或.crt结尾。 | | 自动升级 | 可选，开启后节点将自动升级系统应用模块。 注意： 升级过程中可能导致节点数据上传中断。 | 4. 填写配置节点数据信息后，单击"立即创建"。 图2配置节点数据 ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001899051908.png "点击放大") 表2专业版节点信息 | 参数名称 | 说明 | |:---|:---| | 数据存储路径 | 默认（允许修改存储路径）。 | | 监控运维 | 默认勾选"监控运维工具"。 | | $edge_omagent应用 | 负责边缘节点远程监控和运维，提供日志上报、远程SSH、CPU等指标上报、文件上传下载能力。 | | 日志配置 | 系统日志：边缘节点上已部署的系统应用产生的日志。 应用日志：边缘节点上已部署的用户定义应用所产生的日志。 - 云端日志级别：on, off, trace, debug, info, warn, error, fatal。其中，on表示上传所有日志至云端，off表示不上传日志至云端，其余可选项代表按日志级别采集，选择后将只采集目标级别及以上的日志（模糊匹配）。日志级别的严重程度等级由低到高依次为：trace, debug, info, warn, error, fatal。 - 日志文件大小：日志文件大小限制，单位MB，默认50，取值范围10-1000。某个日志文件如果达到大小限制，则会将文件转储保存至日志目录下。 - 滚动日志周期：日志转储周期，可选项：daily，weekly，monthly，yearly。某个日志文件如果达到转储周期，则会将文件转储保存至日志目录下。日志文件大小和滚动日志周期是同时生效的，满足任何一个条件都会进行日志转储。 - 滚动日志数量：日志文件转储个数，默认5，取值范围1-10。边缘节点保存的转储日志数量如果达到限制，则会删除最早的转储文件。 注意： 1. 当前"云端日志级别"对日志等级采取模糊匹配的策略，若日志消息中存在与日志级别标识相同的关键字，则也可能被采集。 2. 若要开启"云端日志级别"中的trace, debug, info, warn, error, fatal选项，则必须满足以下三个前置条件： 1. 目标节点是基础版节点或++部++ ++署类型为Docker++ 的专业版节点。需注意，++部署类型为KubeEdge++的专业版节点不支持此功能。 2. 已安装$edge_omagent应用，且版本不低于1-1-15-xxx。 3. 应用日志需遵循如下规范打印，以便进行过滤： - 日志级别标识需打印为（大小写均可）：trace、debug、info、warn、error、fatal。 - 每条日志消息以YYYY-MM-DD日期格式作为前缀。 说明： 专业版（部署类型为Docker）和基础版节点只涉及日志级别这一个参数，其他参数只对专业版（部署类型为KubeEdge）有效 。 | | 离线缓存配置 | 可对离线节点上报的数据进行缓存，定义缓存周期（可配置为不过期）跟缓存大小、上报的优先级、路由转发是否开启离线缓存。 | | 可靠性配置 | 可靠性级别分为"中"和"高"2种。中级别：当应用上报属性和点位的频率超过流控值时，超过部分会被丢弃；高级别：当应用上报属性和点位的频率超过流控值时，通过控制模块的发送速度，降低上报频率，报文不会被丢弃。（注意：高可靠性级别的配置需要定制应用的配合，同时会造成性能的损失）。 | | 设备数据格式配置 | 设备的数据格式：即单网关节点中设备的标准数据格式，包含IoTDA1.0物模型格式和属性平铺格式。IoTDA1.0物模型中包含了设备、服务和属性三层结构，具体参考IoTDA网关子设备属性上报报文格式。属性平铺格式，包含设备、属性2层结构，属性结构可以包含自定义结构的拼接，在json中作为一项平铺展开，具体格式请参考[步骤6设备数据格式配置](https://support.huaweicloud.com/usermanual-iotedge/iotedge_03_00041.html)。 须知： 属性平铺格式功能，需要edge_hub应用1-1-38-××版本及以上支持 | 5. 弹出如下对话框，您可以"返回节点列表"也可以"继续创建"。 图3注册成功 ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001945203464.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-iotedge/public_sys-resources/note_3.0-zh-cn.png) 安装部署节点前，请确认机器的IP转发已开启并且已开启自启动，以及7883和8943端口开放。其中，IP转发规则配置如下： 图4IP转发规则配置 ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001355814640.png "点击放大") 1. 检查机器ip_forward in/proc文件系统的值。 ``` cat /proc/sys/net/ipv4/ip_forward ``` 若值等于0，则需要添加配置IP转发规则。 2. 检查配置文件/etc/sysctl.conf是否包含net.ipv4.ip_forward = 1。 如果配置文件中没有net.ipv4.ip_forward参数项，请新增一行net.ipv4.ip_forward = 1。 ``` vim /etc/sysctl.conf ``` 按"i"进入编辑模式，修改完成后按"Esc"退出编辑模式，然后按"Shift"+";"组合键，输入wq并回车，保存修改并退出。 3. 重新加载此文件的值。 ``` sysctl -p ``` 4. 检查7883和8943端口是否开放，如果是华为云服务器，请参考：[安全组](https://support.huaweicloud.com/usermanual-vpc/vpc_SecurityGroup_0001.html)。 #### 安装专业版节点 1. 在"节点管理"的节点列表选择您需要安装的节点，单击右侧"安装"，获得提示。 图5安装 ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001559841484.png "点击放大") 2. 选择支持架构和安装目录，然后单击![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0279901501.png)复制安装命令，使用SSH工具以root用户登录边缘节点服务器后台系统，执行安装命令。 图6提示 ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001972242561.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-iotedge/public_sys-resources/note_3.0-zh-cn.png) 安装命令的选择需要与购买的ecs的架构保持一致。 图7执行安装 ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001898923042.png "点击放大") 图8安装命令执行成功 ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001938484525.png "点击放大") 3. 单击"我知道了"，等待边缘节点的状态变为"在线"，表示该节点已安装并连接成功。 4. 您可以单击"节点名称"，查看该节点详细信息，关于节点详情描述可参见[节点概览](https://support.huaweicloud.com/usermanual-iotedge/iotedge_03_00041.html)。