服务群组_人工智能平台 PAI(PAI)-阿里云帮助中心

对于多个子服务共同承接业务流量的场景，您可以创建服务群组。服务群组拥有统一的流量入口，系统按照流量分配策略将入口流量分配给每个服务。本文为您介绍如何创建服务群组、查看流量入口及修改流量分配策略。

应用场景

通过服务群组功能，您可以实现以下几种典型的应用场景：

灰度发布
将两个服务加入同一个服务群组，一个服务用作生产，一个服务用作灰度，灰度服务配置较少的实例个数，两个服务承载的流量比例按照服务的实例个数进行分配。
新版本服务发布时，您可以先更新灰度服务，并观察线上运行情况。如果运行出现问题，可以将灰度服务版本快速回滚，您也可以停止灰度服务，并将流量切换到生产服务中；如果灰度服务运行正常，则可以全量更新生产服务，更新完成后将灰度服务缩容至0，也可以保留灰度服务继续承载线上少部分流量。
预付费和后付费弹性伸缩
您可以在同一个服务群组中创建服务，将一个服务部署在预付费专属资源组中，并固定服务中的实例个数来支撑基本的业务需求；同时在公共资源组中创建后付费服务，将该服务按照业务属性配置弹性伸缩，满足弹性的业务流量，实现公共资源和专属资源的共用，有效降低成本。
使用异构硬件资源
在GPU加速场景中，单个服务一般使用一种卡型。服务部署完成后，部分卡型在某些地域可能会出现停卡或库存不足的问题，导致服务无法正常扩容。您可以通过服务群组功能，在同一个服务群组中使用不同的卡型动态创建新服务。因为不同卡型对CUDA环境有不同程度的依赖，不同服务可以适配不同的卡型，从而实现多个服务使用异构资源支持同一业务的场景。因为服务群组的流量入口不变，后端在群组中创建多少个服务，均可以实现前端透明无感知。

创建服务群组

创建服务时，您可以指定服务归属于某个服务群组，通过这种方式创建服务群组，并将对应的服务归纳到该服务群组中。

说明

如果您在创建服务时，指定的服务群组名称不存在，则系统会自动创建一个服务群组；如果服务群组名称存在，则新创建的服务会自动加入该服务群组；当服务群组中最后一个服务被删除时，服务群组会自动删除。

下面以创建一个pmml服务群组，并将pmml_prod和pmml_grey两个服务归属到该服务群组为例，示例如何创建服务群组。

通过控制台方式创建

登录PAI控制台，在页面上方选择目标地域，并在右侧选择目标工作空间，然后单击进入EAS。
在灰度发布页签，单击新建群组与服务。
在自定义部署页面，配置参数，并单击部署。
其中：
- 服务名称：参考界面提示信息配置，示例值为pmml_prod。
- 所属群组：选择新建群组，示例值为pmml。
其他参数配置，详情请参见服务部署：控制台。

参照步骤2~3，创建服务pmml_grey归属于服务群组pmml。

服务创建成功后，您可以单击群组名称pmml进入群组详情页面，查看归属于该群组的服务列表。

通过客户端方式创建

准备服务的配置文件service.json。
- pmml_prod服务的配置文件。
```
{
  "name":"pmml_prod",
  "model_path":"http://examplebucket.oss-cn-shanghai.aliyuncs.com/models/lr_xxxx.pmml",
  "processor":"pmml",
  "metadata":{
    "cpu":1,
    "instance":4,
    "group":"pmml",
    "traffic_state": "grouping"
  }
}
```
- pmml_grey服务的配置文件。
```
{
  "name":"pmml_grey",
  "model_path":"http://examplebucket.oss-cn-shanghai.aliyuncs.com/models/lr_xxxx.pmml",
  "processor":"pmml",
  "metadata":{
    "cpu":1,
    "instance":1,
    "group":"pmml",
    "traffic_state": "grouping"
  }
}
```
配置文件中的关键参数解释：
- group：用来指定服务归属于哪个服务群组，即创建的服务群组的名称。
- traffic_state：用来指定服务在服务群组中是否承载流量，支持配置以下两个参数：
  - grouping：表示承载服务群组中的流量。
  - standalone：表示不承载服务群组中的流量。
  说明
  如果配置文件中没有配置traffic_state字段，表示服务默认承载服务群组的流量。如果您不希望加入服务群组的服务立即承载服务群组的流量，可以将traffic_state字段配置为standalone。
  当服务群组中只有一个服务时，如果该服务的流量状态为standalone，则系统会自动将该服务的流量状态设置为grouping。
配置文件中的其他参数解释，详情请参见命令使用说明。
创建服务及服务群组。
您可以登录eascmd客户端后使用create命令创建服务及服务群组，如何登录eascmd客户端，请参见下载并认证客户端，使用示例如下所示。
```
$ eascmd create service.json
```

查看服务及群组详情。

您可以使用ls命令查看服务及群组详情，使用示例如下所示。

$ eascmd ls

系统输出如下结果。

[RequestId]: 716BEBFC-E8A4-51FD-A3F7-56376B167923
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+
|        SERVICENAME        | INSTANCE | CPU | MEMORY |      CREATETIME      |      UPDATETIME      | STATUS  | WEIGHT | TRAFFICSTATE |       SERVICEGROUP        |
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+
| pmml_prod                 |        4 |   1 | 1000M  | 2022-06-05T14:30:49Z | 2022-06-05T14:30:49Z | Running |     80 | grouping     | pmml                      |
| pmml_grey                 |        1 |   1 | 1000M  | 2022-06-05T14:31:38Z | 2022-06-05T14:31:38Z | Running |     20 | grouping     | pmml                      |
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+

其中

SERVICEGROUP 为pmml，表示两个服务均归属于pmml服务群组。
TRAFFICSTATE为grouping，表示两个服务同时承载流量，且两个服务的流量比例为80%和20%，与实例个数相匹配。

后续操作指引：

服务群组及服务创建完成后，您可以查看服务群组或服务的流量入口，用于对外提供服务，详情请参见查看流量入口。
服务群组及服务创建完成后，默认为分组切流方式，根据服务实例个数分配流量，支持修改流量分配策略，详情请参见修改流量分配策略（分组切流）。

查看流量入口

服务群组拥有统一的流量入口，群组中各服务还拥有独立的流量入口，说明如下：

服务群组流量入口。
```
<endpoint>/api/predict/<group_name>
```
使用示例。
```
http://182848887922****.vpc.cn-shanghai.pai-eas.aliyuncs.com/api/predict/pmml
```
您可以在控制台页面，参照下图操作指引，查看服务群组流量入口。
从该流量入口进入的流量，会根据不同的流量分配策略分配到服务群组中不同的服务，您可以在服务群组中创建服务或删除服务，该入口始终保持不变，您可以使用该入口地址进行在线调试。
单个服务流量入口。
```
<endpoint>/api/predict/<group_name>.<service_name>
```
使用示例。
```
http://182848887922****.vpc.cn-shanghai.pai-eas.aliyuncs.com/api/predict/pmml.pmml_prod
```
您可以在控制台页面，参照下图操作指引，查看单个服务流量入口。
该入口与具体服务的生命周期相关联，从该入口进入的流量始终会流入指定的服务中，与流量分配策略无关。相关的服务删除后，该入口会同时被销毁。通常在完成群组切流后，您仍需要使用该入口的访问地址访问服务并进行在线调试。

修改流量分配策略（分组切流）

EAS当前支持分组切流方式，并支持修改流量分配策略。

切流模式介绍

新创建服务并指定服务群组后，加入服务群组的服务默认为分组切流方式，且直接开始承接服务群组的流量，服务群组按照服务中实例的个数来分配流量，因此实例数多的服务会分配更多的流量。

修改流量分配策略

通过控制台方式，参照下图操作指引，修改流量分配策略。打开③位置开关，表示该服务承接流量；关闭③位置开关，表示该服务不承接流量。

使用release命令修改流量分配策略，命令格式如下所示。如何登录eascmd客户端，请参见下载并认证客户端。

$ eascmd release <service_name> -s grouping|standalone

其中：

<service_name>：服务名称，需要替换为待修改的服务名称。
grouping|standalone：修改后的状态，包括grouping和standalone，分别表示承载流量和不承载流量。

使用示例如下所示：

修改服务pmml_grey的状态为standalone，即不承载流量，可执行如下命令。

$ eascmd release pmml_grey -s standalone

系统输出结果如下。

Confirmed to release service [pmml_grey] to group traffic [Y/n]yes
[RequestId]: 40C787DF-8900-5F7A-8A01-30F7D5A8BF3B
[OK] Service [pmml_grey] has entered the traffic state: standalone

使用eascmd ls命令查看服务的运行状态，系统输出如下结果。

[RequestId]: 83BE3FBB-8CE2-5008-B435-1938A20B13AA
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+
|        SERVICENAME        | INSTANCE | CPU | MEMORY |      CREATETIME      |      UPDATETIME      | STATUS  | WEIGHT | TRAFFICSTATE |       SERVICEGROUP        |
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+
| pmml_prod                 |        4 |   1 | 1000M  | 2022-06-05T14:30:49Z | 2022-06-05T14:30:49Z | Running |    100 | grouping     | pmml                      |
| pmml_grey                 |        1 |   1 | 1000M  | 2022-06-05T14:42:41Z | 2022-06-05T14:42:41Z | Running |     0  | standalone   | pmml                      |
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+

其中服务pmml_grey的TRAFFICSTATE已更新为standalone，WEIGHT为0，表示全部的流量由pmml_prod承载。

修改服务pmml_grey的状态为grouping，即服务承载流量，可执行如下命令。

$ eascmd release pmml_grey -s grouping

系统输出结果如下。

Confirmed to release service [pmml_grey] to group traffic [Y/n]yes
[RequestId]: 40C787DF-8900-5F7A-8A01-30F7D5A8BF3B
[OK] Service [pmml_grey] has entered the traffic state: grouping

使用eascmd ls命令查看服务的运行状态，系统输出如下结果。

[RequestId]: 83BE3FBB-8CE2-5008-B435-1938A20B13AA
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+
|        SERVICENAME        | INSTANCE | CPU | MEMORY |      CREATETIME      |      UPDATETIME      | STATUS  | WEIGHT | TRAFFICSTATE |       SERVICEGROUP        |
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+
| pmml_prod                 |        4 |   1 | 1000M  | 2022-06-05T14:30:49Z | 2022-06-05T14:30:49Z | Running |     80 | grouping     | pmml                      |
| pmml_grey                 |        1 |   1 | 1000M  | 2022-06-05T14:42:41Z | 2022-06-05T14:42:41Z | Running |     20 | grouping     | pmml                      |
+---------------------------+----------+-----+--------+----------------------+----------------------+---------+--------+--------------+---------------------------+

其中服务pmml_grey的TRAFFICSTATE已更新为grouping，并按实例比例承载了20%的流量。