服务管理

一个服务是指开发者开发和部署的一个应用程序。

当前版本提供的服务管理功能包括：新建或修改服务、服务的版本管理、各版本的运行状态管理，以及服务运行日志的查询。

点击管理控制台页面左侧的“服务管理”-“概况”链接进入服务列表界面。该界面将显示用户已经创建的所有服务。用户可以新建服务，或者修改服务的描述信息。

全部服务

点击“新建服务”按钮，弹出的新建服务的对话框如下图所示。

新建服务

所属产品

服务是与产品相关联的。当前版本仅支持为每个产品至多关联一个服务。
服务名

服务名可由字母、数字或连字符组成（不可使用下划线）。同时，要求新添加的服务不能与开发者已创建的服务同名（不记大小写）。当前版本也不支持修改已创建服务的名字。
描述

服务的描述信息可以为中英文文本。

在服务列表页面中，点击某行的“修改描述”链接可以修改服务的描述信息（如下图所示）。

修改服务

当前版本仅支持修改服务的描述信息。

服务是指具体的应用程序。AbleCloud提供了针对应用程序的版本管理功能。

在服务列表页面中，点击某行的“版本管理”链接可打开服务版本的管理页面。在该页面中，用户可以新建版本、管理版本的运行状态。

服务的版本管理

点击“新建版本”按钮，弹出的新建版本的对话框如下图所示。

新建版本

主版本号，副版本号和修订版本号

AbelCloud以“<主版本号>-<副版本号>-<修订版本号>”（如：1-0-1）的格式描述应用程序的完整版本号。主版本号、副版本号以及修订版本号的值均为整数。
描述

版本的描述信息可为中英文文本。
App文件

应用程序的可执行文件。新建版本时必须指定与该版本匹配的应用程序可执行文件。 AbleCloud目前仅支持Java运行环境（jre-7及更新版本），要求提交的文件是基于AbleCloud发布的Java版服务开发框架的应用程序。同时要求将所有的类库、配置文件、资源文件以及启动脚本等以ZIP方式压缩、打包为一个文件，且解压缩后直接得到如下目录及文件而不包含其它中间目录：
- /config
- /lib
- start.sh
该ZIP文件的大小不能超过64M。

版本的运行状态是指与该版本对应的可执行程序的运行状态，包括：

对于同一个服务的主版本号相同的应用程序，AbleCloud支持且最多支持其中一个处于运行状态；对于同一个服务的主版本号不同的应用程序，AbleCloud支持且最多支持其中两个处于运行状态。

用户可以通过“上线”、“下线”和“回滚”等操作来管理版本的运行状态。

上线

处于“未上线”状态的版本可以执行“上线”操作。

在前述AbleCloud关于运行状态约束的基础上，被“上线”的版本必需高于其所属主版本中目前“已上线”的版本。如果满足该条件，AbleCloud将上线该版本，并下线与该版本同主版本号的“已上线”的版本；如果不满足该条件，AbleCloud将不允许上线该版本。

如果当前已有分属于两个不同主版本号的版本处于“已上线”状态，并且被“上线”的版本不属于这两个主版本号，那么AbleCloud也不会允许上线该版本。此时需要用户手动下线某个已上线的版本，之后再上线该版本。
下线

处于“正在上线”或者“已上线”状态的版本可以执行“下线”操作。
回滚

“已上线”的版本可以回滚至与其同主版本号的低版本程序，即当前版本被下线，而指定的同主版本号的低版本上线。点击“回滚”链接，在弹出的对话框中可以选择回滚的目标版本。

在版本列表页面中，点击某行的“修改描述”链接可以打开修改对应行版本描述信息的对话框（如下图所示）。

修改版本

当前版本仅支持修改版本的描述信息。

当前版本支持查询服务的某版本应用程序最近一周以来的日志记录。

点击管理控制台页面左侧的“服务管理”-“日志查看”链接进入日志查询页面。在该页面中用户可以指定查询日志的具体参数。参数配置界面如下图所示。

日志查看

服务

指定待查询应用程序所属的服务。
版本

指定待查询的应用程序的版本号。
日志级别

AbleCloud将日志记录划分为DEBUG、INFO、WARNING、ERROR和FATAL等五个级别。查询日志时需指定待查询的记录的级别。“ALL”表示查询所有级别的记录。
时间段

当前版本最多支持查看最近一周以来的日志记录。
过滤条件

过滤条件允许用户指定关键词来匹配日志记录的内容：包含该关键词的日志记录才会显示在查询结果中。不指定过滤条件则表示不使用该规则。

需要注意的是，AbleCloud可能同时运行同一应用程序的多个实例来满足其所处理业务规模的需求，而来自这些实例的日志记录将会交错出现在查询结果中。