批量节点注册
使用场景
如果您需要对大量相同类型的边缘节点进行管理、更新与维护,这时使用注册边缘节点的方法逐一纳管边缘节点会有些繁琐。
IEF提供批量节点注册功能,使得相同类型的边缘节点能够预安装软件,在上电联网后能自动纳管到IEF中。批量节点注册与边缘节点满足一对多的关系,提高管理效率,也节约了运维成本。
批量节点注册流程
批量纳管边缘节点的流程如下:
- 准备边缘节点,边缘节点需要满足一定的规格要求,请参见配置边缘节点环境在节点上完成环境配置。
- 创建批量节点注册作业,获取配置文件和注册软件,并预安装到边缘节点上,具体请参见批量纳管边缘节点。如果在启动脚本配置注册命令,设备上电联网后会自动纳管成为IEF的边缘节点。
创建批量节点注册作业
- 登录IEF管理控制台,在“总览”页面切换实例为铂金版。
- 选择左侧导航栏的“批量管理 > 节点注册”,单击页面右上角的“批量节点注册”。
- 配置基本信息。其中带“*”标志的参数为必填参数。
- 名称:批量节点注册作业的名称。
- 描述:作业的描述信息。
- 标签:标签可用于对资源进行标记,方便分类管理。
- 属性:属性是键值对形式,请输入属性名和属性值。
- 单击页面右下角的“创建”,节点注册可选“通过证书注册”和“通过token注册”两种方式。
- 方式一:通过证书注册。下载配置文件、EdgeCore Register和EdgeCore Installer。
为保障节点安全,您现在必须下载配置文件和工具,稍后将无法找回。
图1 下载配置文件、EdgeCore Register和EdgeCore Installer
- 根据页面提示,单击“下载cert_1.tar.gz配置文件”下载配置文件。
- 根据您边缘节点的CPU架构选择EdgeCore Register和EdgeCore Installer,单击“下载EdgeCore Register”和“下载EdgeCore Installer”。
- 方式二:通过token注册。下载边缘节点安装工具并保存安装凭证。
图2 下载边缘核心软件
图3 安装命令
- 根据您边缘节点的CPU架构选择边缘节点安装工具,单击“下载EdgeCore Installer”。
- 保存界面中的安装命令。安装命令有两种执行方式,您可以任选其中的一种方式保存即可。
- 方式一:通过证书注册。下载配置文件、EdgeCore Register和EdgeCore Installer。
- 将下载的文件上传至边缘节点,稍后参见批量纳管边缘节点操作指南纳管边缘节点。
批量纳管边缘节点
按照批量节点注册作业完成页的操作指南,在边缘节点执行纳管操作。
- 以具备sudo权限的用户登录边缘节点。
- 执行如下命令解压配置文件、EdgeCore Register和EdgeCore Installer。
sudo tar -zxvf edge-installer_1.0.10_x86_64.tar.gz -C /opt
sudo tar -zxvf edge-register_2.0.10_x86_64.tar.gz -C /opt
sudo tar -zxvf cert_batchNodes.tar.gz -C /opt/edge-register/(“通过token注册”时不需要执行此命令)
edge-installer_1.0.10_x86_64.tar.gz、edge-register_2.0.10_x86_64.tar.gz和cert_batchNodes.tar.gz请替换为创建批量节点注册作业下载的文件名。
- (可选)配置节点预置信息文件。
批量纳管边缘节点会采用默认配置进行节点纳管,其中
- 节点名称为节点hostname和mac地址的组合“hostname_mac”
- GPU和NPU默认不启用
- Docker默认启用
如需自定义配置节点信息,可以参考以下操作配置节点信息文件。
cd /opt/edge-register
vi nodeinfo
在nodeinfo文件中填入节点的配置信息,其格式如下所示(下面样例罗列了所有可配置的参数,可以根据场景需求配置其中的参数值,对于不需要自定义配置的参数可以删除示例中对应的参数配置):
包括节点名称、描述、是否启用GPU、NPU、NPU类型、属性以及日志配置等,具体参数解释请参见API参考 > 注册边缘节点。
{ "name": "nodename", "description": "", "enable_gpu": false, "enable_npu": true, "npu_type": "***", "enable_docker": true, "attributes": [ { "key": "key1", "value": "value1" } ], "log_configs": [ { "component": "app", "type": "local", "level": "debug", "size": 100, "rotate_num": 5, "rotate_period": "daily" } ], "device_infos": [ { "device_ids": ["15696983-5ee6-43b4-9653-5d8512813dcc"], "relation": "camera", "comment": "devicedescription" } ], "mqtt_config": { "enable_mqtt": false, "mqtts": [] }, "tags": [ { "key": "name", "value": "value" } ] }
- 执行如下命令,纳管边缘节点。
- 通过token注册
cd /opt/edge-register; ./register --mode=identifier --identifier=token注册的凭证
token注册的凭证请替换为创建批量节点注册作业时保存的安装凭证identifier字段。
执行完成后,可以根据查看纳管的节点查看节点是否注册成功。
您也可以配置上电启动脚本,在边缘节点上电时自动执行注册命令,在上电脚本中添加注册命令:cd /opt/edge-register; ./register --mode=cert
如果注册命令的执行结果返回值为0,则表示注册成功。
- 通过token注册