进程程序包

1、简介

• 进程程序包（简称“程序包”），是一种特殊的配置项，它指定了进程模式应用的程序服务入口。
• 一个程序包对应一个程序入口，一个进程模式应用可以包含多个程序包。即部署一个进程模式应用，可以下发多个程序服务。

• 进程模式应用 与 容器模式应用 整体框架是相似的：

  • 容器模式应用支持添加多个容器，进程模式应用也支持添加多个程序包。
  • 容器模式应用的容器镜像对应进程模式应用的是程序包。容器镜像和程序包，本质都是一组程序的打包，入口只有一个。
  • 容器和程序包都支持卷、环境变量、启动参数配置。
  • 容器模式应用下发的是容器镜像地址和配置卷（或者是配置文件下载地址），然后由baetyl边缘计算框架下载容器镜像文件(docker pull)和配置文件。
  • 进程模式应用下发的是程序包地址和配置卷（或者是配置文件下载地址），然后由baetyl边缘计算框架下载程序包(http request)和配置文件。

2、规范

2.1 边缘侧运行程序目录规范

一个程序包下发下发以后，在边缘侧由baetyl进行动态组装，组装以后必须包含以下两部分组成：

1. 程序入口配置文件：

   • 文件名称：program.yml，固定不变

   • 文件内容：`entry: "[可执行程序名称]"，比如：

     • entry: "script-name.sh"，入口是一个可执行脚本
     • entry: "bin/emqx"，入口是一个可执行二进制程序，是一个相对于program.yml所在的文件路径

2. 可执行程序，有两种形式：

   • 可执行脚本：比如一个名称为script-name.sh的shell脚本。
   • 可执行二进制程序：如果程序有外部依赖文件，可以将可执行程序与外部依赖文件/目录放在一起。

说明：

• script-name可替换为实际的脚本名称。
• 不管是可执行脚本，还是可执行二进制程序，都必须授予可执行权限。可以通过 chmod +x [file-name] 命令授予可执行权限

2.2 程序包创建规范

基于边缘侧运行程序目录规范，云端创建程序包有多种方式：

1. 将program.yml文件和可执行程序文件/目录放在一起，然后整体打包成zip包。在创建程序包的时候引入这个zip包，程序包只包含1个变量。

2. 将program.yml文件单独压缩成一个zip包，将可执行程序也压缩成一个zip包。在创建程序包的时候，同时引入program.yml文件zip包和可执行程序zip包，程序包包含2个变量。

2.3 程序包变量名规范

• 进程应用下发以后，边缘计算框架baetyl基于应用配置信息下载程序包当中定义的文件。使用变量名作为文件名，因此如果程序包当中引入了多个文件，需要保证变量名是唯一的。
• 边缘计算框架会根据操作系统架构动态下载程序包当中定义的文件，通过变量名称进行匹配，变量名称包含操作系统架构的文件，将会被下载。操作系统架构主要有以下5种，darwin-amd64、linux-amd64、linux-arm-v7、linux-arm64-v8 、 windows-amd64。所以程序包的变量名可以是linux-arm64-v8-emqx.zip、emqx-linux-arm64-v8.zip，只要包含架构即可。

3、创建程序包

3.1 准备程序包依赖文件

此处以emqx程序程序包制作未来进行说明，可以下载如下文件，然后上传至个人的对象存储，也可以直接使用http下载地址：

• emqx-program-yml-1.zip
• emqx-5.0.8-ubuntu20.04-arm64.zip

3.2 创建程序包配置项

进入配置管理页面，切换至进程程序包tab面，然后点击创建程序包，进入创建程序包页面，填写相关信息：

• 名称：配置项名称，不可为空，不可重复
• 描述：配置项描述信息，可为空
• 标签：函数配置项标签，默认添加baetyl-config-type:baetyl-program系统标签

• 配置项：点击引入文件，在弹出对话框当中进行如下配置：

  • 平台：选择linux/arm64-v8
  • 类型：此处可以使用HTTP
  • URL：输入上述的程序包依赖文件的URL
  • 文件名：自定义

• 点击确定以后，配置变量名，两个变量名如下，必须包含架构名称

  • emqx-program-yml-1.zip-linux-arm64-v8
  • emqx-5.0.8-ubuntu20.04-arm64-linux-arm64-v8
• 点击确定，完成程序包创建。

4、直接导入程序包与应用

程序包和应用支持导入功能，将下面两个配置文件下载（右键->另存为）至本地，然后导入到BIE系统当中。

• 进程程序包-emqx-5.0.8-ubuntu20.04-arm64-linux-arm64-v8.json
• 应用-emqx-5.0.8-ubuntu20.04-arm64-linux-arm64-v8.json

因为应用当中引用了程序包，所以需要先导入程序包，再导入应用。

5、查看与更新程序包

• 创建完成后在程序包列表看到已有程序包，点击程序包名称或查看进入程序包详情页。可以在详情页继续引入程序包文件，流程同创建时相同。
• 可以继续引入其它平台的程序包支持其它平台，也可以点击已有文件编辑按键，修改已有文件引入。
• 如程序包已绑定至进程模式应用，对程序包配置更新会同步更新关联进程应用的配置。如进程应用已经部署至设备，对程序包改动会同步至设备，触发进程应用同步更新。

6、删除程序包

在程序包列表页，点击需要删除程序包的删除按键，弹出确认对话框，点击确认完成程序包删除。

需要注意的是，程序包如已经与进程模式应用关联，无法直接删除程序包，必须将程序包和进程模式应用解除关联才可以删除程序包。