远程调试

远程调试

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防止启动自动运行三方节点的测试影响数据模型测试的效率，当订阅设备或者数据模型并进行相关操作时，控制台打印相关信息