边缘Agent使用

边缘Agent使用

1. 功能介绍

边缘应用，往往没有公网IP，因此正常情况下无法被外网应用调用服务。因此，我们提供了【边缘Agent】，用于让无外网IP的本地应用接入统一的服务总线，并能够被来自云端的应用调用。其工作原理是：

• Agent会与云端建立一个长连接通道；

• 本地应用按照服务模型的路径定义（http://localhost:${port}/${服务模型}/${模型接口}）实现接口；

• 云端应用按照服务模型的标准方案调用接口时，平台会自动转发该请求到Agent；

• Agent会负责调用该本地应用的接口；

2. 部署Agent

Agent可以提供两种运行模式：Java SDK模式和独立运行模式。前者是以SDK包的形式包含在应用内，随服务应用一起运行；后者是以独立运行的形式，独立于服务应用运行。

2.1 独立运行模式

• 下载Agent

地址：remote agent

• 配置启动文件

配置文件使用如下JSON格式表达，并保存到文件中：

{
    "serverUrl":"wss://backend-iotx-remote-debug.aliyun.com:443",
    "authType":"application",
    "appKey":"chenlu_test_app_key",
    "appSecret":"chenlu_test_app_secret"
}

• 启动Agent

使用如下命令启动jar应用：java -jar iotx-remote-debug-agent-java.jar backend [config_file_path]其中“config_file_path”，为上节中的配置文件。

2.2 Java SDK模式

• 依赖包的引入：

  <groupId>com.aliyun.iotx</groupId>
  <artifactId>iotx-remote-debug-sdk-core</artifactId>
  <version>1.0.1-SNAPSHOT</version>

• 启动Agent

BackendBootstrap bootstrap = new BackendBootstrap()
            .authType(AuthType.APPLICATION.getType())
            .serverUrl(agentConfig.getServerUrl())
            .appKey(agentConfig.getAppKey())
            .appSecret(agentConfig.getAppSecret());

ChannelFuture closeFuture = bootstrap.start();
closeFuture.sync();
return bootstrap;