应用：一次性交付-边缘接入

本章将为您介绍如何管理【一次性交付-边缘外部接入】。

整体流程

一个“一次性交付的边缘外部接入应用”的上线整体流程，包括：创建应用、应用配置、应用测试、版本发布。

应用管理

登录卖家后台，单击应用接入 > 应用管理进入应用列表。

1.创建应用

在应用接入 > 创建应用页面填写应用基本信息，如图所示：

选择应用类型为一次性交付，如图所示：

根据应用实际情况选择部署方式与系统类型，如图所示：

• 应用类型：

  • 账号分发：用户付款后，只需要交付账号给其使用。

  • 实例分发：用户付款后，单独为客户部署一套应用。

  • 一次性交付：定制项目或交付型应用。

• 部署方式：

  • 云端外部接入：用户的应用部署在自己管理的云服务器中。

  • 边缘外部接入：用户的应用部署在自己管理的边缘服务器内（无公网IP。）

2.应用详情

2.1下载Agent

创建应用完成后点击管理在应用详情页面可以看到AppKey、AppSecret、AppId等信息，应用的连接状态会默认未连接，您需要点击下载Agent才可以进行下一步操作，若有疑问也可以查看帮助文档 如图所示：

2.2配置Agent

将下载的Agent解压后，新建一个名为backend.json 的文件放于同一路径下，如图所示：backend.json是Agent反向代理的配置文件，您可以根据需要来命名这个文件，但是请保证和启动命令中的文件名称保持一致，backend.json文件编写的serverUrl为线上环境，您无需修改，只需要修改appkey和appsecert即可，具体内容如下：

{
    "serverUrl":"wss://backend-iotx-remote-debug.aliyun.com:443",
    "authType":"application",
    "appKey":"您创建应用的appkey",
    "appSecret":"您创建应用的appsecert"
}

2.3启动Agent

backend.json文件编写完成后，在您的终端中路径选择Agent解压文件夹启动Agnet，启动命令为：java -jar iotx-remote-debug-agent-java.jar backend 当您查看到启动日志出现release session successfully，就表明Agent已经初始化并连接云成功，如图所示：

3.应用详情

点击初始化应用完成后可以看到权限和模型、应用测试、发布版本功能，如图所示：

3.1模型与权限

接口授权

点击模型与权限 > 接口授权，在应用的分发模式，每一次分发，都有可能归属到不同的买家。因此，每一个应用实例，都需要一个唯一的值来代表应用实例的身份。这里，我们采用了AppKey + AppSecret的模式。随之而来的是，我们如何给AppKey授权。应用在调用IoT的各种API的时候，拿的这个AppKey需要被事先授权。因此，应用上架时，有必要清晰的指出该应用会调用哪些API，这样才能在AppKey产生的那一刻，给他授相应的权限，在此页面可对实例进行授权等操作，如图所示：

数据模型

点击数据模型 > 添加数据模型，在列表中，除了选择要声明的模型之外，还要选择版本、数据权限、订阅。其中，数据权限有三种：查、增 | 查、增 | 删 | 改 | 查，分别对应不同的操作类型。如图所示：

服务依赖

点击服务依赖 > 添加服务模型（应用为服务依赖方添加，服务提供方无需添加），选择对应的服务模型，并配置服务模型的API，如图所示：

服务提供

点击服务提供 > 添加服务模型（应用为服务提供方添加，服务依赖方无需添加），选择对应的服务模型，并配置相应的端口，端口与系统应用的服务提供端口保持一致，如图所示：

4. 应用测试

应用测试包括数据模型测试、服务依赖测试、服务提供测试，如图所示：

数据模型测试

点击数据模型测试 > 初始化测试环境 > 模拟发送数据，如图所示：

点击发送，可以在页面看到发送的数据信息，如图所示：

服务依赖测试

点击服务依赖测试 > 启动模拟服务，使用客户端发送请求到模拟服务，在此可以查看调试调用记录，如图所示：

服务提供测试

点击服务提供测试 > 启动模拟服务，可以查看服务提供模型的接口列表，并对接口进行验证，如图所示：

调试接口界面可以查看模型接口发送的参数是否正确，如图所示：

5. 发布版本

应用调试无误，可选择发布版本，版本发布后将不能再进行调试、修改、删除等操作。