【华为云IoTEdge开发实战】Java开发如何通过IoT边缘ModuleSDK进行进程应用的开发

举报
华为IoT云服务 发表于 2022/12/16 15:40:00 2022/12/16
【摘要】 为解决用户自定义处理设备数据以及自定义协议设备快速接入IOT平台的诉求,华为IoT边缘提供ModuleSDK,用户可通过集成SDK让设备以及设备数据快速上云。IoT边缘平台应用功能有自定义处理设备数据(即数据处理),自定义协议设备快速接入(即协议解析),IT子系统接入(即IT应用),并且支持容器化部署和安装包部署的方式。

1、操作场景

使用ModuleSDK开发插件应用,并以进程方式跑在服务器上。

2、代码解析

代码解析样例:

3、注册节点

注册节点,请参照注册边缘节点

4、设备建模&发放

请参照设备建模&发放

5、项目打包

将集成ModuleSDK进行项目打包。

根据您的需求进行相关代码的开发,并将项目打包,以编辑器IDEA为例:

1.选中项目->右键open Module setting

2.Artifacts->单击+>JAR->From modules with dependencies->模块选择monitor-app,选择monitorappMain入口类,注意MANIFEST.MF位置选择模块根目录->单击apply

image001.png

3.单击上方build选项->选择build Artifacts->monitor-app:jar->build

4.打包完成得到monitor-app.jar文件。(如遇到错误(Invalid signature file digest for Manifest main attributes)请使用压缩文件进入metf目录删除.rsa.mf文件)

image003.png

6、制作插件包

1.插件包制作。

a.插件包格式要求如下:

插件包仅支持.tar.gz .tar或者 .zip格式。

插件包结构如下:

app.zip

├── ****.jar //可执行jar文件,必须

├── start.sh //启动脚本 必须文件 当前不提供参数方式启动

└── stop.sh //停止脚本 非必须

b.构建插件包。

monitor-app为例,在项目打包后得到monitor-app.jar

monitor-app.jar文件的同目录下创建start.sh,内容如下:

function log(){

    echo "`date "+%Y-%m-%d %T"`: $1"

}

log "[INFO] start execut process."

#调试时可打开,确认sdk需要的环境能被获取

#echo "${device_id}" > test_enviroment.file

pwd

#更新环境变量,防止找不到java命令。

source /etc/profile

#运行文件在/var/IoTEdge/downloaded-job/run下面

java -jar ./monitor-app.jar  > monitor_running.log  2>&1

monitor-app.jarstart.sh一起压缩得到monitor-app.zip

注意:

  1. 插件包升级时,会删除运行目录的所有文件,注意持久化文件的存储。插件包的运行路径为{installer_dir}/IoTEdge/downloaded-job/run/{moduleId}/{appVersion}/
  2. 当前插件包的大小限制为最大500M
  3. 程序内对于文件的访问使用相对目录访问(因为程序的安装目录是不确定的)。
  4. 程序不允许包含后台运行的程序,可以包含多级进程,所有程序均为sh的子进程。
  5. 进程压缩包命名规范:英文字母或者数字或者“_”,”.” ,长度不超过64,不允许出现空格。

说明:

  1. 插件包为一层压缩结构,即插件包的压缩包解压之后直接为sh脚本所在目录的结构形式,不能多一层目录。
  2. sh脚本为必须脚本,启动时默认调用该脚本进行启动,当前支持root用户以及非root用户(固定为1000用户,root需要确定是否能够成功依赖系统库)启动,用户可以在start.sh脚本中自由修改自己的启动方式以及环境变量的修改等。
  3. sh为非必须的脚本,但是用户如果需要优雅停止的话,需要在改脚本中书写自己进程的停止方式(文件监控、接口调用等)。如果没有该脚本的话,默认对进程组先发送SIGTERM信号,如果进程组对该信号没有处理,达到最大等待时间则发送SIGKILL信号强制停止。整个停止的最大周期为10s

2.插件包上传。

a.开通对象存储服务OBS

进程包上传方式需要开通对象存储服务OBS,请参考对象存储服务 OBS_快速入门

b.上传进程包。

上传方式,请参照对象存储服务(OBS)

注意:

请设置桶策略为【公开读】,如未设置请前往“OBS首页 > 单击桶ID > 访问权限控制 > 桶策略中设置

7、添加应用

以安装包部署方式为例,将应用程序打包成安装包文件,并上传到 对象存储服务(OBS)

1.IoT边缘单击创建应用,进入软件部署配置、运行配置,并确认发布。

image005.png

2.在左侧导航栏,单击应用管理,选择应用名称进入页面,查看应用为已发布状态。

image007.png

8、部署应用

在边缘节点安装成功后可部署边缘应用。

操作步骤

1.访问IoT边缘,单击立即使用进入IoT边缘控制台。

2.选择左侧导航栏“IoT边缘 > 边缘节点进入页面。

3.选择您的边缘节点,单击节点名称进入节点详情页。

4.在左侧导航栏选择应用模块 > 模块管理页签,单击部署应用

部署边缘应用

image009.png

5.根据页面提示填写参数信息后,单击确认

部署应用

image011.png

部署应用

参数名称

说明

功能用途

您可以根据实际情况选择:

数据处理:提供设备数据处理能力。

协议解析:提供设备接入能力。

本地子系统集成:提供IT子系统集成能力。

网关管理:扩展边缘节点的协议接入能力,当前支持ModbusOPC-UA协议接入。

混合应用:包含数据处理、协议转换、子系统接入、网关管理、数据采集其中两个及以上功能的应用。

数据采集:提供OT数采能力。

边缘应用

在应用管理中创建的应用名称。

选择版本

在应用管理中创建并发布的应用版本。

模块名称

自定义。

6.弹出操作成功对话框,再单击确认返回部署边缘应用列表。

确认

image013.png

7.单击刷新,当应用的实例状态由部署中转为运行中表示部署成功。

image015.png

只有应用版本是多部署的时候,且运行配置的网络类型是端口映射后,可在部署应用时,或应用后添加端口映射。

运行配置,请参考端点和部署配置

image017.png

image019.png

注意:

  • 标准版默认部署sys_edge_hubsys_edge_agent,高级版默认部署sys_edge_hub
  • 标准版和轻量版默认部署$edge_omagent,在注册节点过程中可选择是否自动部署。
  • 只有已发布的应用版本允许被部署。
  • 如果应用添加时配置了支持多模块部署 同一个节点下是允许部署多次的。
  • 应用支持的架构和边缘节点架构相同才能够部署成功。
  • 如果应用需要AI加速卡,边缘节点没有AI加速卡将部署失败。
  • 部署应用模块支持升级操作,可选择高版本也可选择低版本,目前只有Agent应用升级失败会回退到原版本。
【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。