构建第三方应用程序

在开始构建第三方应用程序之前，请下载并安装适用于 Junos OS 演化的 JET SDK 和适用于 Junos OS 演化的 JET 工具包。您可以在 Juniper Extension Toolkit（适用于 Junos Evolved） 页面找到这些文件：

• 适用于 Junos OS 演化的 JET SDK： jet-junos-evo-sdk--releaseEVO.deb

• The JET Toolkit for Junos OS Evolved： jet-junos-evo-toolkit-release-EVO.tar.gz

生成文件是构建和安装第三方应用程序的必要文件。生成文件需要包含其他文件的路径，如 SRC 文件、配置文件和 .yaml 文件。它还控制必要文件的安装位置。

SRC 文件包含应用程序的源代码。您可以使用 C、C++ 或 Python 编写 SRC 文件。这些文件对于第三方应用程序的功能是必需的。

脚本文件包括预安装、安装后和预卸载脚本。这些可选文件是 shell 脚本，您可以对其进行自定义以满足应用程序的需求。

• 预安装脚本会在安装第三方软件包之前运行。这些脚本通常用于测试和检查设备上的各种因素。例如，您可以创建一个预安装脚本，在开始安装之前检查正在运行的 Junos OS 演化版。

• 安装后脚本在安装第三方软件包后运行。这些脚本包含完成安装后要运行的命令。例如，为包创建其他日志文件或日志记录目录。

• 卸载前脚本会在卸载第三方软件包之前运行。这些脚本通常用于清理在安装第三方软件包期间创建的文件夹和文件。

注意：

所有脚本在成功执行时必须返回零，在失败时必须返回非零。

可以在任何文件夹中创建脚本。在使用该工具创建 Jet-evo 第三方包的过程中，您可以输入每种脚本类型的路径，它们将安装在设备上的 / data/var/external/current-evo-version/ 文件夹中。有关该工具 Jet-evo 的详细信息，请参阅 Jet-evo 工具配置。

注意：

如果要创建自定义脚本，我们建议您不要使用任何 bash 将创建其他 CLI 输出的命令。您可以将 CLI 输出重定向到您自己的日志文件。

服务文件是受控应用程序的必需文件 systemd 。这些文件控制应用程序策略并确定应用程序在哪些节点和路由引擎上运行。

您必须将服务文件放在软件包目录中的 root-fs etc/systemd/system/ 文件夹中。

下面的示例是 .service 名为 Sample App的应用程序的文件。此 .service 文件定义启动应用程序的路径，以及运行应用程序所需的系统状态。

以下字段是必填字段，应使用与示例文件相同的语法：

• 后

• 之前

• 故障时

• 工作目录

• 执行启动

• ExeStopPost

.yaml文件是受控应用程序的必需文件SysMan。这些文件用于传递应用程序特定的策略，这些策略用于在安装期间创建systemd基于服务单元和SysMan基于的策略。 文件还用于确定应用程序在哪些节点和路由引擎上运行。 .yaml

注意：

如果在包中包含同一应用程序的和.yaml.service文件，.service则文件属性将优先，并且应用程序将被视为sysman受控应用程序。

第三方包可以附加多个服务。对于SysMan每个附加的服务，每个应用程序都必须有一个单独的.yaml文件，其中服务名称作为.yaml文件名。文件名应与服务名称匹配，而不是与包名称匹配，因为第三方包名称可能与包中包含的服务不同。 .yaml

必须将文件usr/conf放在.yaml包目录中的root-fs文件夹中。

文件 .yaml 由多个字段组成，其中包含有关相应应用程序的信息。有关文件字段的定义 .yaml ，请参阅以下列表：

binpath	定义二进制可执行文件的路径。
exec-start	定义如何启动应用程序，包括启动应用程序所需的路径和参数。此字段对应于 ExecStart 服务单元中的 systemd 字段。
working-dir	使用二进制文件定义父目录的路径。
id	控制应用程序的名称。应与 .yaml 文件名匹配。
network	设置网络类型，值为 internal 或 external。在设备外部通信的应用程序应使用该 external 值。
on-exit	控制退出时重新启动应用程序的设置。 restart：控制应用程序在退出时是否重新启动，并带有 true 或 false 值。
resource	设置应用程序使用的系统资源限制： max-memory：控制每个应用程序实例允许使用的最大内存量。 node-attribute：控制将在其上运行应用程序的节点类型，其值如 -re 和 fpc。 node-type：使用和 fpc等-re值控制要在其上运行操作的节点类型。 startup：控制如果用户定义的 Junos OS 演化版配置存在truefalse或值，则在安装后是否启动应用程序。 instances：控制应用程序将在其上运行的节点以及可以运行的最大实例数。 all_nodes：控制应用程序是否将在具有或false值的所有true节点上运行。 max_num_of_instances：使用数字值控制应用程序可以运行的最大实例数。

以下示例.yaml文件显示了将在主路由引擎上运行的示例应用程序的配置，只有一个实例。设置字段all_nodes以防止false应用程序在所有路由引擎上运行。将max_number_of_instances1字段设置为 将应用程序限制为 1 个实例。node-attribute将字段设置为 使-re应用程序在路由引擎上运行。使用此配置，如果主路由引擎出现故障，应用程序将自动在备份路由引擎上启动。

该工具 Jet-evo 用于命名第三方软件包、设置版本号、运行安装脚本以及设置第三方软件包的安装位置。这些变量都由运行 jet-evo 命令时设置的选项控制：

注意：

有关生成用于Jet-evo该工具的私钥的信息，请参阅生成签名密钥。

• 必需参数
• 可选参数
• 语法示例