管理微服务

查看应用列表

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“应用列表”，查看该引擎下当前账号下的所有应用的详细信息。

   支持使用应用名称搜索目标应用，也可以选择环境，筛选应用。

查看微服务列表

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“微服务列表”，查看该引擎下当前账号下的所有微服务。

   支持使用微服务名称搜索目标服务，也可以选择环境、应用筛选服务。

查看微服务详情

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“微服务列表”下待查看的微服务名称，进入微服务详情页查看实例列表、被调用服务、调用服务、动态配置、灰度发布和服务契约等信息。

创建微服务

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 选择“微服务列表 > 创建微服务”，参考下表配置微服务参数。参数前面带*号的是必须设置的参数。

   参数	说明
   *微服务名称	输入微服务名称，例如：myServiceName。
   *微服务应用	输入微服务所属应用的名称，微服务之间是通过应用隔离的。
   *版本	输入微服务的版本号，默认为1.0.0。 微服务版本号格式为“X.Y.Z”，“X.Y.Z.B”型，其中X、Y、Z、B为数字且范围在0-32767，长度为3-46个字符。
   *微服务环境	选择微服务所在环境，用于隔离微服务数据，包括：版本、实例。
   描述	输入微服务描述信息。

6. 单击“确定”。

   创建完成后，微服务会显示在微服务列表。

清理无实例版本

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 选择“微服务列表 > 清理无实例版本”，勾选待清理的无实例微服务版本。

   支持使用微服务名称搜索目标服务，也可以选择环境、应用筛选微服务。

6. 单击“确定”。

删除微服务

• 微服务删除后，可通过恢复备份数据进行恢复。
• 如果删除的服务有实例，需要先将对应实例删除，否则服务会再次注册。

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“微服务列表”，进入微服务列表：
   • 批量删除微服务：勾选待删除的微服务，单击微服务列表上面的“删除”。
   • 删除单个微服务：单击待删除微服务所在行“操作”列的“删除”。

6. 在输入框输入“DELETE”确认删除，单击“确定”。

动态配置

配置项使用明文存储，请勿附带敏感数据。

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录 ”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“微服务列表”。
6. 单击微服务名称。
7. 单击“动态配置”，进入动态配置页签。在“动态配置”页签可进行如下操作：

   操作	步骤
   新建配置	操作步骤可参考创建微服务级配置，其中，“配置范围”已选择“微服务级配置”，“微服务”为当前微服务。
   查看历史版本	单击目标配置项对应“操作”列的“查看历史版本”，可查看历史版本配置。
   禁用配置项	在目标配置项对应“操作”列选择“更多 > 禁用”。 在弹出确认框，单击“确认”禁用该配置。
   修改配置项	单击目标配置项对应“操作”列的“编辑”。 在配置详情页面单击“编辑”。 在“配置内容”区域输入新的配置信息。 单击“保存”，保存配置修改。
   删除配置项	在目标配置项对应“操作”列选择“更多 > 删除”。 单击“确定”，删除配置。

灰度发布

为保障新特性能平稳上线，可以通过灰度发布功能选择少部分用户试用，待新特性成熟以后，再切换版本让所有用户使用。

• 基于ServiceComb Java Chassis框架开发的微服务需要在POM中添加依赖darklaunch或handler-router，并且在配置文件中增加servicecomb.router.type=router。

• 基于Spring Cloud Huawei框架开发的微服务需要在POM中增加依赖spring-cloud-starter-huawei-router。

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。

2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 在“微服务列表”页签，单击微服务名称，进入详情页面，单击“灰度发布”。
6. 单击“添加发布规则”，弹出“创建新规则”弹框。
   • 按照权重方式添加灰度规则。
     1. “发布规则”选择“权重”，显示权重规则设置页签。
     2. 对权重规则进行设置，权重规则配置项如下表所示。

        配置项	说明
        规则名称	自定义规则名称。
        作用域	选择规则作用的版本。 勾选“是否添加自定义版本”，根据界面提示添加新版本。
        规则配置	配置所选版本的引流权重，流量会按照配置的百分比分配给所选择的服务版本。

     3. 单击“确定”，完成权重规则配置和灰度发布。
   • 按照自定义方式添加灰度规则。

     只有ServiceComb Java Chassis框架开发的微服务通过依赖darklaunch实现灰度能力和Spring Cloud Huawei框架开发的微服务实现灰度能力，可通过此功能实现下发灰度规则。依赖handler-router下发的灰度规则需要手动在配置中心下发。

     1. “发布规则”选择“自定义”，显示自定义规则设置页签。
     2. 对自定义规则进行设置，自定义规则配置项如下表所示。

        配置项	说明
        规则名称	自定义规则名称。
        作用域	选择规则作用的版本。 勾选“是否添加自定义版本”，根据界面提示添加新版本。
        规则配置	设置匹配规则的参数，使用darklaunch实现灰度能力时，设置的是policyCondition内容，其他设置的是Headers参数。 Spring Cloud Huawei框架开发的微服务设置的Headers参数请参见设置Header参数 。 参数名 根据契约的参数名或Header自定义的key作为参数名设置。 规则 通过选择匹配符和契约的Key或Header的Key对应的Value确定符合该规则的请求将被分配到微服务版本中。 说明： 当匹配符选~时，可使用*或者?字符的模糊匹配规则自定义规则值，*表示任意长度字符，?表示一个字符。比如，字段Name的规则值配置为*1000时，表示Name后4位为1000的都能匹配上。 当匹配符没有选~时，*或者?字符只是普通字符，没有模糊匹配的作用。

     3. 单击“确定”，完成自定义规则配置和灰度发布。

下发灰度发布规则样例如下：

• ServiceComb Java Chassis框架开发的微服务，在微服务引擎页面下发规则是基于darklaunch依赖下发的，通过配置自定义方式添加灰度规则。

  

  其中，在规则配置中，参数名Key必须是契约里面存在的。有可能服务端接口写的是String paramA，加了注解实际生成的是paramB，所以这里应该是写paramB。

  

  通过选择匹配符和契约的Key对应的Value确定符合该规则的请求将被分配到微服务版本中。

  

  成功下发的规则内容如下：配置项为cse.darklaunch.policy.${serviceName}。

  

• ServiceComb Java Chassis框架开发的微服务，依赖handler-router下发的灰度规则需要手动在配置中心下发，配置项为：servicecomb.routeRule.${serviceName}，内容如下：

  

• Spring Cloud Huawei框架开发的微服务，微服务引擎页面下发灰度规则如下：

  

创建微服务实例

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。
3. 单击“微服务目录”。
   • 未开启安全认证的微服务ServiceComb引擎，请执行5。
   • 开启安全认证的微服务ServiceComb引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务ServiceComb引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 在“微服务列表”页签，在待操作的微服务“操作”列，单击“创建微服务实例”。
6. 在“创建微服务实例”弹出框，输入参数信息，其中带*为必填项，如表1。

   表1 创建微服务实例信息

   信息类型	参数	描述
   微服务信息	*所属微服务	自动填充该实例所属微服务名称，此处不可修改。
   	*所属应用	自动填充该实例所属微服务在创建时所属的应用名称，此处不可修改。
   	*所属环境	自动填充所属微服务在创建时所属的环境，此处不可修改。
   	*微服务版本	可在下拉列表中选择所属的微服务版本。
   实例信息	*实例名称	自定义输入实例名称。输入任意字符，长度为1~64。
   	*实例地址	输入实例所在地址，如192.168.5.23:8080，最多支持输入5个地址，用“,”分隔。
   数据中心信息	数据中心名称	输入数据中心名称，如datacenter。长度为1~128。
   	数据中心区域	输入数据中心区域，如region01。 长度为1~128。
   	数据中心可用区	输入数据中心可用区，如az1。 长度为1~128。

7. 单击“确定”，实例创建成功，新创建的实例会显示在“实例列表”页签下。

查看实例列表

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。

2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。

3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“实例列表”，进入实例列表查看引擎的所有实例。

   支持使用微服务名称搜索目标实例，也可以选择环境、应用筛选实例。

修改实例状态

“实例状态”是微服务实例信息的一部分，用于反映微服务实例的状态。

在创建并部署组件中通过绑定微服务引擎同步的微服务实例不支持状态修改。

微服务实例状态说明请见下表。

1. 登录ServiceStage控制台，选择“微服务引擎 > 引擎实例”。
2. 在页面上方“微服务引擎”下拉列表，选择待操作的微服务引擎。

3. 单击“微服务目录”。
   • 未开启安全认证的微服务引擎，请执行5。
   • 开启安全认证的微服务引擎，请执行4。

4. 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。
   

   • 首次连接微服务引擎，请输入root账号名及创建微服务引擎时输入的密码。
   • 创建账号请参考新增账号。

5. 单击“实例列表”，选择目标实例，修改微服务实例状态。
   • 下线

     单击“操作”列的“下线”，修改微服务实例状态为“下线”。

   • 在线

     在“操作”列，选择“更多 > 在线”，修改微服务实例状态为“在线”。

   • 摘机

     在“操作”列，选择“更多 > 摘机”，修改微服务实例状态为“摘机”。

   • 拨测

     在“操作”列，选择“更多 > 拨测”，修改实例状态为“拨测”。