驱动支持云端发布和内置发布两种形式。云端发布驱动,是将驱动文件托管到控制台中驱动管理页面;内置发布驱动,是将驱动内置到网关。本文主要描述通过云端发布驱动的步骤。
前提条件
操作步骤
- 登录边缘计算控制台,在左侧导航栏单击驱动管理。
- 在驱动管理页面自研驱动页签下,单击的新建驱动。
- 在新建驱动页面,根据提示设置驱动参数。
- 驱动信息
表 1. 驱动信息参数说明 参数 描述 驱动名称 自定义驱动的名称。支持大小写英文字母、数字和英文下划线(_),必须以英文字母开头,不超过20个字符。 通信协议类型 驱动开发所依赖的行业标准通信协议。当前支持的协议类型有Modbus、OPCUA和自定义。 语言类型 驱动的语言类型,支持Node.js 8、Python 3.5、C和Java 8类型。 其中,若选择C类型,则还需要选择驱动的CPU架构。
驱动是否内置 选择是否内置驱动文件。 - 是:无需上传驱动文件,使用本地内置驱动。详情请见内置发布。
- 否:需要上传驱动文件,通过云端部署通道直接部署驱动。
云端发布必须选择否。
驱动文件 驱动是否内置选择否后,单击上传文件,上传您的驱动文件。 说明 仅支持上传.zip格式的文件,文件大小不能超过50 MB。驱动版本 设置驱动的版本,必须是该驱动唯一的版本号,即一个驱动不可以设置两个相同的版本号。 驱动适配的边缘版本 选择驱动适配的边缘版本,即该驱动只能在该边缘版本及以上版本的网关中运行。 驱动版本描述 描述您创建的驱动,可以为空。 - 驱动配置
表 1. 驱动配置参数说明 参数 描述 配置格式 配置格式有如下三种: - 键值对配置
- JSON格式
- 配置文件
键值对配置表 配置格式为键值对配置时显示的参数。 单击新增配置,通过设置配置名称、值、注释来配置驱动。
最多添加100个键值对。
配置内容 配置格式为JSON格式时显示的参数。 编写JSON格式配置内容,内容不超过1 KB。编写内容时,系统自动校验格式。若格式错误,可根据系统提示编写正确格式的内容。
上传配置文件 配置格式为配置文件时显示的参数。 需要在本地编写配置文件并上传。配置文件的编写,请参见驱动编码。
- 容器配置
参数 描述 是否使用宿主机host模式 选择是否隔离容器的网络。直接使用宿主机网络环境。 - 是:表示不隔离容器的网络,直接使用宿主机网络环境。
- 否:表示隔离容器的网络,需要设置网络端口映射。
网络端口映射 当是否使用宿主机host模式为否时出现的参数。函数的网络环境和宿主机的环境是完全隔离的。通过网络端口映射,将容器内函数的监听端口映射到宿主机的某一个端口上,实现不同主机上的客户端程序,能够访问该函数提供的服务。最多支持映射10条网络端口。 例如,运行在宿主机容器内的
fc-http-server
函数,通过80端口对外界提供服务。此时,其它主机上的客户端程序,无法通过访问宿主机的80端口,访问到fc-http-server
函数。因此需要将fc-http-server
函数所在的容器端口映射到宿主机的某一个端口上(例如将容器内的80端口映射到宿主机8080端口),允许其它主机上的客户端程序通过访问宿主机的IP地址:8080
,访问到容器内部的fc-http-server
函数。是否启动特权模式 容器内的root用户实际上只是宿主机的一个普通用户。若在容器内部做修改系统时间、使用mount命令等需要root权限的操作,则需要赋予容器privileged特权。
说明 特权模式下,容器内部拥有宿主机的root权限,而且宿主机的所有设备会默认映射到容器内部,即无需配置设备映射。设备映射 当是否启动特权模式为否时出现的参数。设备管理系统和宿主机的环境是完全隔离的。当一个函数需要访问宿主机的设备(例如串口)时,需要将设备映射到运行函数的容器内部。最多可添加10个设备映射。 卷映射 文件系统和宿主机的环境是完全隔离的。当一个函数需要访问宿主机的文件时,需要将文件映射到运行函数的容器内部。最多可添加10个卷映射。 - 配置校验
表 2. 配置校验参数说明 参数 描述 驱动配置 勾选表示将该驱动配置到边缘实例并关联子设备后,必须设置驱动配置,才可以将驱动部署到边缘实例。 设备配置 勾选表示将该驱动配置到边缘实例并关联子设备后,必须设置设备配置,才可以将驱动部署到边缘实例。
- 驱动信息
- 完成参数的设置并上传成功驱动文件后,单击确认。您可以在自研驱动页签中看到刚刚创建的驱动。
相关操作
- 在驱动管理页面自研驱动页签,单击驱动操作栏中的版本管理。
- 在版本管理面板,单击相关操作按钮,管理该驱动的版本信息。
操作 描述 新增版本 单击新增版本,可为该驱动增加新版本,详细操作及参数说明,请参见本文上方设置驱动参数步骤。 发布 单击发布,在弹出的确认发布驱动版本对话框,确认发布驱动信息后,单击发布。 说明 驱动发布成功后,不可以删除该版本驱动,只能查看或下载该版本驱动。编辑 驱动版本的状态为未发布时才有的操作按钮。单击编辑,可修改该版本驱动的信息,参数说明,请参见本文上方设置驱动参数步骤。 下载 单击下载,可下载该版本驱动文件。 删除 驱动版本的状态为未发布时才有的操作按钮。单击删除,可删除该版本驱动。 查看 驱动版本的状态为已发布时才有的操作按钮。单击查看,可查看该版本驱动信息,也可以修改该版本驱动信息,参数说明,请参见本文上方设置驱动参数步骤。 - 在云端发布驱动后,即可将驱动分配到边缘实例,关联子设备,通过边缘实例的部署,将驱动和子设备部署到边缘端。详细信息,请参见驱动调试。