版本管理
功能概述
应用版本对于一款应用来说是非常重要和关键的概念。一款应用从创建、发布到更新,整个过程中会涉及到多个应用版本,每个版本中都包括完整的应用服务功能,其主要属性如下。
-
版本名称
用数字或者字符表示应用的版本号,例如 1.0、2.1.20。若没有提供版本名称,系统将自动指定一个。
-
版本状态
包括准备提交、审核中、被拒绝、已通过、已上架、已下架和已删除几种状态,不同的状态对应不同的操作。
-
配置文件
用于描述应用具体服务的各类文件,文件格式支持 TAR,TAR.GZ,ZIP 和 TAR.BZ,后面将详细介绍配置文件及其制作方法和步骤。
-
版本描述
此描述内容主要用来记录此版本的具体更新,便于用户在升级应用时做详细了解。
操作步骤
创建应用版本
-
通过 Web 浏览器,登录 AppCenter 应用管理平台。
-
点击页面右上角的应用开发,进入应用开发页面。
-
点击目标应用名称,进入应用详情页面,默认进入应用版本标签页。
-
若当前操作为创建应用的第一个版本,则进入标签页后,直接点击创建版本。若当前操作为应用新增版本,则点击左侧版本列表中的 + 创建版本*。
-
进入新应用版本编辑页面。用户根据页面提示信息填写相关参数。页面参数说明如下。
参数 说明 版本 ID
由系统生成,无法修改。
系列
应用发布后就无法更改。
版本名称
用数字表示应用的版本号,例如 1.0、2.1.20。若没有提供版本名称,系统将自动指定一个。
版本排序
用于定义当前版本在应用版本列表中的排序。
配置文件
选择上传满足要求的配置文件包,用于后期部署该应用。
-
配置文件包的格式支持
TAR、TAR.GZ、TAR.BZ和ZIP。详情可参考如何创建配置文件包。 -
上传完成后,点击切换成选择镜像。
选择镜像
关联镜像。镜像文件,只能关联未共享给他人的自有映像。详情可参考如何创建镜像文件。
版本描述
该描述会出现在应用展示详情页面,字数请勿超过 2000 字。
版本详细说明
该描述不在应用详情页面展示,用于内部人员对该版本的了解,字数请勿超过 1000 字。
价格
填写服务价格,该价格不包含资源价格。
-
-
确认上述信息填写无误后,点击右上角的
保存,完成操作。 -
成功创建的应用版本,在左侧版本列表中状态显示为
准备提交。
测试应用版本
提交审核之前需要对应用版本进行测试。
-
延续前文步骤,进入应用开发页面。
-
在应用开发卡片区域,点击目标应用名称,进入应用详情页面,默认进入应用版本标签页。
-
在左侧版本列表中,选择待测试应用的版本后,点击版本编辑表单
配置文件下方的去控制台测试,即可前往控制台,部署集群实例并进行测试。
说明 测试区必须是应用镜像所在区,只有应用版本当发布后,镜像文件才会复制到其它区。
-
在测试部署集群实例时需要填写创建表单,提交之后便开始部署过程,部署完成之后可在企业云平台的 Console 页面查看相应的集群实例,并进入其详情页面查看
基本信息、节点列表以及配置参数等信息,同时可对集群实例做各项操作以测试其可用性等。详情可参考集群管理。
提交审核
若当前版本测试已通过,可以将此应用版本提交审核。需要注意的是,提交审核之前请完善必要的应用信息,否则会影响审核结果。完善应用信息可参考如何修改应用信息。
-
延续前文步骤,进入应用开发页面。
-
在应用开发卡片区域,点击目标应用名称,进入应用详情页面,默认进入应用版本标签页。
-
在左侧版本列表中,选择待提交审核的版本后,再点击右上角的发布版本 > 提交审核,完成操作。
-
在左侧版本列表中,目标应用版本的状态显示为
审核中。 -
审核工作将在 5 个工作日内完成。
-
当审核被拒绝时,页面上会显示详细的拒绝原因,请调整后重新提交审核。
-
审核通过后,用户可以选择发布该应用。
-
发布应用
应用版本通过审核之后,服务商可以根据自己的计划来选择时间上架此应用。应用一旦上架则意味着应用会出现在应用中心的应用列表中,用户可以随时浏览、购买并部署该应用。
| 注意 |
|---|
上架的应用版本不允许做任何修改。如有问题需要修复或服务需要升级等,请按前面的步骤提交新版本,等待审核通过后上架新版本,再将旧版本下架或删除。 |
-
延续前文步骤,进入应用开发页面。
-
在应用开发卡片区域,点击目标应用名称,进入应用详情页面,默认进入应用版本标签页。
-
在左侧版本列表中,选择待发布应用的版本后,再点击右上角的发布,完成操作。
-
成功发布的应用,在左侧版本列表中,显示
已上架。
下架应用版本
下架应用版本,需要提工单联系管理员,提交下架申请并等待管理员审核。下架的应用版本因为还有用户在使用,所以对于这些用户提交的工单,开发者依旧要给予及时的响应和服务。当所有版本都下架时该应用也会自动下架。
版本记录
开发者可以查看所有创建过的版本列表,以及每个版本详细的审核记录。
附录
制作配置文件
配置文件包是由一组根据应用开发模板规范描述应用实例的文件组成。描述内容包括应用实例基础架构、生命周期及监控告警等。如:创建应用实例时需要的参数,每个参数的可选项,以及各个节点的镜像等。
-
按照需求,准备配置文件包。完整的配置文件包需包含以下文件。
文件名 说明 config.json
该文件包含最终用户创建此应用实例时通过 UI 需设置的参数等信息。
cluster.json.mustache
该文件包含创建此应用需要用到的镜像、多少类节点、服务启动命令等信息。
locale/en.json
英文翻译文件。
locale/zh-cn.json
中文翻译文件。
config.json中定义的参数,在控制台上由用户设置。控制台支持语言国际化,默认情况下,所有语言都会按配置项中的label和description展示。如果您想要适应不同的语言,需要在提交的应用中包含一个locale文件夹,并添加对应语言的翻译文件。 -
将上述准备完成的文件,进行压缩打包。压缩包格式支持
TAR,TAR.GZ,ZIP或TAR.BZ。 -
上传配置文件包。
镜像制作请参考:镜像制作。
我们提供了从简单到复杂的应用配置文件样例,详情请参看云应用开发模板规范 - 完整版。