远程调试

1. 整体介绍

远程调试仅支持云端托管类型的应用。配置完版本后，可以对该编辑的版本进行远程调试，在开启调试前完成应用配置、模型与权限配置。开启远程调试后，该调试应用7天后会自动销毁，自研节点和初始化节点可随时进行镜像的替换进行调试，支持镜像自动打包。当调试应用节点都正常启动时，可进行数据模型、服务模型、免登路径的集成测试。
因配置版本发布后原有配置节点属性无法修改，该功能主要用于编辑中版本的调试，确保版本配置的正确性后再发布版本，以免出现发布的配置异常又无法修改的场景。

2. 远程调试概述

• 前置条件：在开启调试前完成应用配置、模型与权限配置。
• 开启远程调试后，该调试应用7天后会自动销毁，自研节点和初始化节点可随时进行镜像的替换进行调试，支持镜像自动打包。
• 当调试应用节点都正常启动时，可进行数据模型、服务模型、免登路径的集成测试。
• 主题流程如下：

3.远程调试流程

3.1 调试环境初始化

登录物联网应用服务平台，点击应用托管->应用管理->远程调试。如下图所示。

注意：版本管理必须存在一个编辑中的版本才可初始化调试环境
点击初始化测试环境进行远程调试应用的环境初始化。初始化时间大致为3-5分钟。如下图所示。

调式环境初始化完成页面，可以进行应用测试、下载Demo代码、更换版本、镜像打包等操作。如图所示。

3.2 更换版本和镜像打包

注意：

• 应用部署前，需要先进行初始化节点的部署。
• 每次只能更换一个自研节点。更换版本实际上是应有的新部署。
• 初始化节点和自研节点需要手动启动
  • 点击更换版本，选择镜像仓库版本
  • 点击镜像打包，辅助镜像打包（仅支持jar和war）
    

4.应用集成

4.1 应用部署

在完成版本更换和镜像打包后，会出现新更换的应用的部署详情，如图所示。

4.2 应用运维

新版本应用部署成功后，可以对应用的日志、监控、终端等进行操作
点击日志，可以进行节点日志的查看，其中包括应用的文件输出、事件输出、和终端数据等。如图所示。

应用日志

应用事件

应用输出

4.3 应用测试

当调试应用全部启动成功后，点击应用测试，如下图

可进行数据模型、服务模型（服务依赖，服务提供）、Oauth免登的测试。如图所示。

4.4 下载demo测试

启动成功后，点击自研节点名称旁的下载Demo代码**，**下载java springboot应用自动加载依赖配置项，直接启动自动测试三方组件，集成了测试用例可测试服务模型、数据模型链路

5.Demo测试

5.1 概述

仅自研节点提供下载Demo代码功能，demo仅默认支持java语言的demo，下载demo的配置文件自动生成该节点依赖的三方节点属性，用于本地测试三方节点是否可正常连接运行。并集成了数据模型、服务模型、open API等sdk，调整参数可直接进行调试

5.2 示例

• 配置版本

自研节点依赖所有阿里云节点和三方节点，三方节点不支持存储节点和ElatiSearh节点的测试

• 下载Demo

启动调试环境，并下载相关自研节点的Demo代码

• demo结构

demo分为三个module，分别为hosting-iot、hosting-middleware、hosting-start。
hosting-iot为基础类module存放公用的类以及工具类；
hosting-middleware存放三方节点相关的类；
hosting-start为主要的module，三方节点的测试以及数据模型、服务模型、openApi都集成在此，该自研节点所依赖的三方节点属性都自动生成在resources下的application.properties文件中，无需修改

**

• 三方节点测试

三方节点测试满足两种方式：
1.启动Application类即可，控制台会打印依赖的三方节点信息测试结果


2.进入ProviderController类注释@RestController，然后启动Application。
启动成功后访问http://127.0.0.1:8080/home.html，等待片刻后即可展示三方节点的测试结果

• 数据模型

远程调试的所有节点全部启动后，可点击应用测试进入测试页面，选择数据模型并初始化测试环境。
注意：远程调试前需要在版本管理>模型与权限权限申明内添加数据模型的权限，并在数据模型模块添加数据模型。
进入DataModelTest类调整相关参数可进行新增数据、修改数据、删除数据、数据列表的操作，运行测试用例前请注释StartService类@Componen防止启动自动运行三方节点的测试影响数据模型测试的效率

• 服务模型

远程调试的所有节点全部启动后，可点击应用测试进入测试页面，选择服务提供测试并启动模拟服务。
注意：远程调试前需要在版本管理>模型与权限服务提供模块添加服务模型。
进入ServiceProvideTest类调整相关参数可实现本地sdk服务提供的调用，运行测试用例前请注释StartService类@Componen防止启动自动运行三方节点的测试影响数据模型测试的效率

• OPEN_API

注意：远程调试前需要在版本管理>模型与权限权限申明内添加相关接口权限
进入OpenApiTest类调整相关参数可实现openApi的本地调用，运行测试用例前请注释StartService类@Componen防止启动自动运行三方节点的测试影响数据模型测试的效率

• H2

注意：需要开启订阅功能才能获取消息，比如数据模型添加时选择订阅选项
进入Http2Test类启动，运行测试用例前请注释StartService类@Componen防止启动自动运行三方节点的测试影响数据模型测试的效率，当订阅设备或者数据模型并进行相关操作时，控制台打印相关信息