单账号云端托管应用

本章将为您介绍如何开发、管理单账号云端托管应用。

整体流程

一个“单账号云端托管应用”的上线整体流程,包括:创建应用、基础配置、部署测试、版本发布、应用升级。

单云托应用整体流程

操作路径:登录应用开发工作台,单击 应用管理 进入应用列表

创建应用

创建应用 页面填写应用基本信息,如图所示:

创建完成后,进入应用概览页面,点击初始化应用,填写应用初始化版本的基本信息,网络限制属性指定应用访问的带宽大小。

基础配置

1. 托管配置编排​

版本创建完成后,在版本列表的操作选项中,选择托管配置编排。

托管配置编排是对一个应用的定义。包括一份应用中的节点构成、节点的配置、启动顺序等,如图所示:​

单云托流式编排

应用配置可视化编辑页面分为三部分内容:

  • 左侧部分为节点:显示已支持的各类节点,所有节点配置请查看节点说明

  • 中间部分为画布:显示应用需要的节点及部署顺序关系。注意⚠️,节点间的部署顺序关系,是通过连线来表示的,连线箭头所指节点先部署,连线起点后部署。

  • 右侧部分为节点属性:显示某个节点可以配置的参数。

左侧的节点列表,分成了四类:

  • 自研节点:用户自己上传的镜像的载体。一份配置,可以又多个自研节点。

  • 阿里云节点:一个节点,在应用被部署之后,对应阿里云RDS产品的一个实例(如一个RDS for MySQL数据库实例)。

  • 三方节点:各类主流开源中间件Docker镜像。这一类镜像完全来自于第三方,功能、性能、质量、安全等,均保持不变。

  • 初始化节点:这类节点属于辅助节点,在整个部署的生命周期,只会执行一次(其他节点通常不止一次,比如节点健康检查失败就会重启)。

2. 免登路径

应用概览页面版本列表中, 点击免登路径,配置OAuth默认路径与自研节点中暴露到外网的端口,如图所示:

​3. 模型与权限

在应用概览页面版本列表中, 点击模型与权限。

3.1 权限声明

单账号应用每次部署都是一个独立的应用实例。因此,每一个应用实例,都需要一个唯一的值来代表应用实例的身份。这里,我们采用了AppKey + AppSecret的模式。随之而来的是,我们如何给AppKey授权。应用在调用IoT的各种API的时候,拿的这个AppKey需要被事先授权。因此,应用进行基础配置时,有必要清晰的指出该应用会调用哪些API,这样才能在AppKey产生的那一刻,给他授相应的权限,在此页面可对实例进行授权等操作,如图所示:

3.2 数据模型

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

3.3 服务依赖

点击服务依赖>添加服务模型(应用为服务依赖方添加,服务提供方无需添加),选择对应的服务模型,并配置服务模型的API,如图所示:​

3.4 服务提供

点击服务提供>添加服务模型(应用为服务提供方添加,服务依赖方无需添加),选择对应的服务模型,并配置相应的端口,端口为自研节点中未勾选暴露到外网的节点,如图所示:

4. 开放能力​

应用概览页面版本列表中, 点击开放能力, 可以为应用添加关联的开放能力,如下图所示:

应用部署

点击实例管理>部署实例,按照界面提示填写参数,如图所示:

参数设置如下:

参数

描述

应用名称

部署后应用实例的名称。该名称需账号内唯一。

应用配置

选择应用概览界面中创建的配置版本。

部署区域

当应用配置为云端配置时,选择已经创建私有集群名称

资源信息状态

展示您选择的配置所有的节点及占有的资源情况

  • 单击部署,执行部署任务。

    • 部署应用时,需要根据应用配置占用相应的云资源。

    • 部署过程可能会花费较长时间,请耐心等待。

  • 应用部署成功后,您可以在部署记录页进行查看、运维和删除等操作,详情请参考运维工具文档。

应用测试

实例部署成功之后,点击实例管理 ,在实例列表的操作中选择测试 ,功能包括OAuth测试、数据模型测试、服务依赖测试、服务提供测试,如图所示:

1. 数据模型测试

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

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

2. 服务依赖测试

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

3. 服务提供测试

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

​​

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

发布版本

应用调试无误,在应用概览页面可点击发布版本,版本发布后将不能在进行调试、修改、删除等操作,如图所示:

升级

版本发布成功后,可对已发布的应用进行升级,升级功能分为两种,应用升级应用补丁,应用升级功能支持可视化编排、模型与权限、免登地址进行修改升级,此类升级属于大版本迭代升级。如仅需要对镜像版本进行修改升级,可选择应用补丁升级,此类升级属于小版本迭代升级。

1. 应用升级

应用概览页面版本列表中, 点击应用升级,此类升级属于大版本迭代升级,迭代应用配置将复制之前的应用配置。可以进入流式配置界面对配置进行升级。如需上线到市场,请在操作中点击“发布”操作,如图所示:

点击应用升级功能可对开放能力、托管配置编排、免登路径、模型与权限进行修改升级,如图所示:

为方便调试,配置升级完成,可以在实例管理>部署实例,选择最新配置进行部署,如图所示:调试无误后可选择发布版本,版本发布后将不能在进行调试、修改、删除等操作,新版本发布后原有版本将继续保留,同时客户可以自行选择升级到哪个版本,若取消升级可点击删除按钮,如图所示:

2. 应用补丁

应用概览页面版本列表中, 点击应用补丁,如图所示:

点击更新镜像,可对镜像版本信息进行修改,此类升级属于小版本迭代升级,如图所示:

​镜像版本更新成功后,点击实例管理>管理>升级,点击图中的“升级”按钮,并选择最新更新版本,即可启动应用更新。完成新版本部署之后,进入应用,确认应用运行情况,如图所示:

​调试无误后可选择发布版本,版本发布后将不能在进行调试、修改、删除等操作,新版本发布后原有版本将继续保留,同时客户可以自行选择升级到哪个版本,若取消升级可点击删除按钮,如图所示: