单账号云端托管应用
本章将为您介绍如何开发、管理单账号云端托管应用。
整体流程
一个“单账号云端托管应用”的上线整体流程,包括:创建应用、基础配置、部署测试、版本发布、应用升级。
操作路径:登录应用开发工作台,单击 应用管理
进入应用列表
创建应用
在 创建应用
页面填写应用基本信息,如图所示:
创建完成后,进入应用概览页面,点击初始化应用
,填写应用初始化版本的基本信息,网络限制属性指定应用访问的带宽大小。
基础配置
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. 应用补丁
在应用概览页面版本列表中, 点击应用补丁,如图所示:
点击更新镜像
,可对镜像版本信息进行修改,此类升级属于小版本迭代升级,如图所示:
镜像版本更新成功后,点击实例管理
>管理
>升级
,点击图中的“升级”按钮,并选择最新更新版本,即可启动应用更新。完成新版本部署之后,进入应用,确认应用运行情况,如图所示:
调试无误后可选择发布版本
,版本发布后将不能在进行调试、修改、删除等操作,新版本发布后原有版本将继续保留,同时客户可以自行选择升级到哪个版本,若取消升级可点击删除
按钮,如图所示: