本章节介绍如何通过镜像部署微服务应用到容器 概述 在微服务云应用平台中接入您的应用进行发布，所支持的介质类型大体上可分为制品（JAR/WAR/TAR包等）、镜像等，您可以按实际需求选择接入的方式。 本文介绍如何通过镜像部署微服务应用到容器。 通过镜像部署微服务应用到容器 前提条件 1. 您已开通微服务云应用平台 2. 您已订购一个云容器引擎实例 3. 您已订购一个nacos注册中心实例 创建环境和导入资源 在左侧导航栏，选择环境管理。在环境列表左上角点击创建环境。环境创建好后，将云容器引擎和nacos注册中心导入到环境中。 创建项目和应用 在左侧导航栏，选择应用列表。在应用列表点击新增项目。展开新增完成的项目，在应用管理下创建应用，技术栈选择 SpringCloud。 项目关联环境 展开项目，在环境管理下将步骤1创建的环境关联上。 创建容器应用实例并部署 基本信息 项目/应用：步骤2创建的应用 应用实例名称：无需修改，使用默认名称即可 技术栈版本：选择1.0.0j180jar 接入方式：选择镜像 应用实例版本：无需修改，使用默认版本即可 企业项目：选择default 部署配置 选择集群：选择步骤1导入到环境中的云容器引擎 镜像类型：选择Demo镜像（支持自购镜像仓库、Demo镜像和MSAP仓库镜像） 选择镜像：选择springcloudprovidernacos.jar镜像使用1.0.0版本 完成以上信息填写后，点击下一步进入到预览页面，确认信息无误后，点击创建按钮，完成应用实例创建。 应用实例创建完成后，直接点击查看实例详情按钮，到实例详情页面。点击上方发布应用实例按钮，进入到应用发布界面。点击右下角发布按钮，进入到发布单详情界面。等待发布单完成初始化后再点击发布按钮进行应用发布。应用开始发布后，可点击应用实例发布单，查看应用发布具体信息。

本节主要介绍使用限制 ServiceStage具有如下限制，下边的每条限制都适用于任何一个Region的每个租户。 限制不等于资源配额限制，而是表示ServiceStage无法向租户提供超过限制的能力，最终用户在技术选型和方案设计时需要注意这些限制。 注册发现 微服务引擎专业版（Cloud Service Engine）限制请参见下表。 表 微服务引擎专业版限制 项目 限制 心跳上报 每个微服务实例最频繁每30s一次 服务发现 每个微服务实例最频繁每30s一次 微服务实例注册 每秒10个 微服务引擎专享版限制请参见下表。 表 微服务引擎专享版限制（最高规格） 项目 限制 备注 心跳上报 每个微服务实例最频繁每20s一次 总限流为2000tps 服务发现 每个微服务实例最频繁每20s一次 微服务实例注册 每秒1000个 微服务引擎专享版引擎类型说明 1.3.0或以上版本的微服务引擎专享版，不同规格均提供了对如下表所示的引擎类型的支持，您可以根据具体业务需求选择使用对应类型的微服务引擎专享版。 表 微服务引擎专享版引擎类型说明 引擎类型 适用业务场景 可用区CPU架构 集群 集群模式部署，主机级容灾，高可用。 x86 单机 单节点部署，不支持容灾，非高可用。 须知“单机”类型的微服务引擎专享版仅适用于开发测试环境，不适用于生产环境。 x86

退订服务器是否影响现有程序运行？ 问题描述 退订服务器是否影响现有程序运行？ 解决方法 容器部署，退订服务器后服务实例将会在CCE集群内重新调度。 如何处理开启了安全认证的微服务引擎专享版开启IPv6后服务注册失败？ 问题描述 基于Java Chassis开发的微服务注册到开启了安全认证的微服务引擎专享版，微服务的注册发现地址使用微服务引擎服务注册发现的IPv4地址，可以注册成功并正常启动。 如果修改微服务的注册发现地址为微服务引擎注册发现的IPv6地址后，注册失败并报错“java.net.SocketException: Protocol family unavailable”。 可能原因 创建微服务引擎专享版时，当选择开启了IPv6的VPC网络时，创建引擎支持IPv6网络。当部署服务使用IPv6网段且选择容器部署时，选择的CCE集群需要开启IPv6双栈开关。 如果选择的CCE集群资源没有开启IPv6开关，就会导致服务网络不通，报错“java.net.SocketException: Protocol family unavailable”。 解决方法 步骤 1 修改部署了微服务应用的环境，添加开启了“IPv6双栈”开关的CCE集群。 修改环境，请参考。 步骤 2 重新部署应用，请参考。 如何处理操作微服务引擎专享版时遇到非微服务引擎本身错误？ 问题描述 在对微服务引擎专享版执行创建、删除、变更规格、升级等操作时，可能会遇到非微服务引擎本身的错误。 例如，在创建微服务引擎专享版时，集群部署失败，报错如下： {"errorcode":"SVCSTG.00500400","errormessage":"{"kind":"Status","apiVersion":"v1","metadata":{},"status":"Failure","code":400,"errorCode":"CCE.01400013","errorMessage":"Insufficient volume quota.","errorcode":"CCECM.0307","errormsg":"Volume quota is not enough","message":"volume quota checking failed as [60/240] insufficient volume size quota","reason":"QuotaInsufficient"}"} 解决方法 页面上展示的错误信息中已经包含相应服务的错误码，根据错误码和错误信息联系相应服务的技术支持工程师提供支持。

本节主要介绍查看微服务引擎信息及接入地址 在“微服务引擎信息”区域可以查看微服务引擎信息。包括引擎的服务注册发现地址以及配置中心地址。 操作步骤 1、从天翼云控制中心单击“微服务引擎”进入管理页面的引擎列表页面。 2、在下方的“微服务引擎”列表区域，查看已开通的微服务引擎基本信息、接入地址。

云容器实例开通 选择云容器引擎>创建集群，开通云容器引擎实例。 前提条件 已创建对应技术栈类型的项目，并且与云容器引擎的环境关联。 已创建支持应用性能监控的技术栈版本。 应用实例创建 1. 登录微服务云应用控制台，左侧菜单栏选择“应用运维>容器应用实例>应用发布>应用实例”，点击左侧顶部“创建应用实例”，填写应用实例基本信息。 2. 在基本信息中选择镜像部署，在点击“下一步”来到“部署配置“，填写部署配置信息。 3. 选择集群以及镜像，这里以goconsumer:1.0.0的demo镜像为例，在“监控及治理方案“选项中勾选“接入应用性能监控”。 4. 点击“环境变量”，设置环境变量信息。 5. 点击下一步，创建应用实例，最后发布部署。 6. 部署成功后，进入对应的容器应用实例的“应用总览”，在“容器组Pod”栏下，选择对应pod的“终端“，点击进入云容器引擎终端控制台。 7. 在终端控制台中执行curl 127.0.0.1:8080/api/user?namehelloworld命令，输出 plaintext { "errno": "0", "errmsg": "成功", "data": { "name": "helloworld" } } 则表示微服务调用成功。 8. 链路调用校验，在指定容器应用实例选择“应用监控>调用链查询”，即可看到对应调用链路，表示应用性能监控正常。

本章节介绍Zookeeper引擎的常见问题 为什么ZooKeeper会出现zxid溢出？ 本文介绍在使用ZooKeeper时，客户端出现zxid（ZooKeeper事务ID）溢出的问题现象、问题原因和解决方案。 问题现象 ZooKeeper集群强制选主，并重置zxid低32位的计数值。 问题原因 zxid是一个长64位的数字。高32位用来表示当前Leader的周期，低32位用来表示当前请求产生的事物在当前Leader周期内的位置。每产生一个新的事务，zxid的低32位就会自动加1。当zxid达到最大值，即zxid的低32位达到0xffffffff，就会触发集群强制选主，并重置zxid低32位的计数值（zxid高32位变为新Leader的周期，低32位变为0）。 解决方案 目前，Server没有规避zxid溢出的方法，请在业务侧提前规避。 对于使用ZooKeeper作为注册配置中心的使用场景：集群选主不会影响到正常使用，客户端在集群选主之后会自动重连恢复。 为什么ZooKeeper会出现APIError溢出？ 本文将介绍使用MSEZooKeeper时，客户端出现APIError报错的问题现象，问题原因和解决方案。 问题现象 使用ZooKeeper客户端出现APIError报错，如下所示： org.apache.zookeeper.KeeperException$APIErrorException: KeeperErrorCode APIError for /xxx。 问题原因 在使用MSE ZooKeeper时客户端触发了MSE ZooKeeper的限流策略。 解决方案 保障ZooKeeper单个会话创建的临时节点（ephemeral）数量少于2000个。 为什么ZooKeeper客户端会出现Connection Loss？ 本文将介绍使用MSE ZooKeeper时，客户端出现Connection Loss报错的问题现象，问题原因和解决方案。

同一个微服务引擎可能会有多个用户共同使用，而不同的用户根据其责任和权限，需要具备不同的微服务引擎访问和操作权限。开启了“安全认证”的微服务引擎专享版，根据用户接入引擎使用的帐号所关联的角色，赋予该用户不同的微服务引擎访问和操作权限。 安全认证具体内容，请参考系统管理。 您可根据实际业务需要，对微服务引擎专享版执行开启或关闭安全认证操作： 开启安全认证 未开启安全认证且状态可用的微服务引擎专享版，根据实际业务需要，可开启安全认证。 开启安全认证后，接入该引擎的微服务组件如果没有配置安全认证参数，或者微服务组件配置的安全认证帐号和密码不正确，会导致该微服务组件心跳失败，服务被迫下线。 关闭安全认证 已开启安全认证且状态可用的微服务引擎专享版，根据实际业务需要，可关闭安全认证。 关闭安全认证后，无论接入该引擎的微服务组件是否配置了安全认证参数，微服务组件的正常业务功能不受影响。 开启安全认证 步骤 1 登录ServiceStage控制台，选择“微服务引擎 CSE”。 步骤 2 选择待操作的微服务引擎，单击引擎名称，进入引擎“基本信息”页面。 步骤 3 在“安全”区域，开启安全认证开关。 如果引擎版本低于1.2.0，执行步骤4。 如果引擎版本为1.2.0及以上版本，执行步骤5。 步骤 4 升级引擎至1.2.0或以上版本。 1. 单击“升级引擎至新版本”。 2. 选择“升级后版本”，查看版本说明，根据需要决定是否升级到该版本后，单击“确定”。 3. 等待升级成功后，单击“返回微服务引擎”。 4. 选择刚升级成功的微服务引擎，单击引擎名称，进入引擎“基本信息”页面。 5. 在“安全”区域，开启安全认证开关。 步骤5 在微服务引擎控制台的“系统管理”页面，开启安全认证。 首次开启安全认证，单击“去开启安全认证”。 需先创建root帐号。输入root帐号的“密码”和“确认密码”，单击“立即创建”。 再次开启安全认证，单击“开启安全认证”。 输入引擎中已关联了admin角色的帐号名称及其密码。 步骤 6 （可选）参考角色管理，根据业务需要，创建角色。 步骤 7 （可选）参考帐号管理，根据业务需要，创建帐号。 步骤 8 在微服务引擎控制台的“系统管理”页面，单击“开启安全认证”。 步骤 9 根据提示确认已经完成所有配置后，勾选“确保已配置”。 步骤 10 单击“确定”。 等待微服务引擎更新完成，引擎状态由“配置中”变为“可用”，开启安全认证成功。

本章节介绍为Dubbo应用构建服务注册中心的方案 事前准备 本文的目的是关于Dubbo 应用接入MSE注册配置中心。首先是工程准备，一般情况下是两个Spring Boot 应用和一个公共的接口模块。 模块说明： 1. commonapi ，公共接口模块（接口），供服务消费者和服务提供者调用。 2. dubboprovider服务提供者模块（接口实现类），依赖commonapi模块。 3. dubboconsumer服务消费者模块（controller），依赖commonapii模块。 消费者和提供者通过公共接口模块进行rpc远程调用。 Dubbo主要相关的依赖项和版本如下所示： org.apache.dubbo dubbospringbootstarter 2.7.15 org.apache.dubbo dubboregistrynacos 2.7.15 在接入之前需要有一个MSE Nacos实例，并获得期访问信息。 公共模块 公共接口模块里面只有一个接口，没有配置文件，打jar包。 public interface InfoService{ String getInfo(); } Provider模块 application.yml配置文件： server: port: 22020 spring: application: name: dubboprovider dubbo: registry: address: nacos://访问地址?usernamenacos&password密码 application: name: dubboprovider protocol: name: dubbo port: PORT scan: basepackages: com.ctg.mse.dubbo.pro.service provider: timeout: 30000 接口实现类，该类实现了公共接口模块创建的接口.注意包路径必须包含在配置文件的sacn.basepackage路径中。 package com.ctg.mse.dubbo.pro.service; import com.ctg.mse.common.InfoService; import org.apache.dubbo.config.annotation.DubboService; import org.springframework.stereotype.Component; @Component @DubboService public class InfoServiceImpl implements InfoService { @Override public String getInfo() { return "Hello , dubbo provider method!"; } } Provider启动类： @EnableDubbo @SpringBootApplication public class DubboProviderApplication { public static void main(String[] args) { SpringApplication.run(DubboProviderApplication.class, args); } }

状态“可用”的微服务引擎专享版，绑定公网IP后可提供公网访问微服务引擎专享版的能力。 须知： 未开启安全认证的微服务引擎无认证鉴权能力，开放到公网面临安全风险，增加系统的脆弱性。如：配置、服务信息等数据资产可能会被窃取。 请不要在生产环境和安全要求较高的网络环境中使用该功能。 开启公网访问 步骤 1 登录ServiceStage控制台，选择“微服务引擎 CSE”。 步骤 2 单击待开启公网访问的微服务引擎名称，进入微服务引擎的“基本信息”页面。 步骤 3 开启“公网访问”开关，在弹出的对话框勾选“我已知晓安全风险”，单击“确定”。 步骤 4 单击“弹性IP地址”后的下拉框。在下拉框中选择可用弹性IP，单击下拉框后侧的“√”。 若下拉框中无可用弹性IP，请单击“创建弹性IP”，根据界面提示创建。 关闭公网访问 步骤 1 登录ServiceStage控制台，选择“微服务引擎 CSE”。 步骤 2 单击待关闭公网访问的微服务引擎名称，进入微服务引擎的“基本信息”页面。 步骤 3 关闭“公网访问”开关。 步骤 4 在弹出对话框单击“确定”。

本章节主要介绍使用微服务仪表盘 您可以通过仪表盘实时查看微服务运行相关的指标，根据丰富实时的仪表盘数据，对微服务做相应的治理动作。 背景说明 如果微服务应用部署在ServiceStage上，部署应用时需要设置微服务引擎，应用会自动获取服务注册发现地址、配置中心地址和仪表盘地址，不需要配置monitor地址，就可以使用仪表盘功能（当前只有Java Chassis和Go Chassis支持仪表盘地址自动发现功能）。 如果是本地启动微服务应用注册到微服务引擎，需要手工配置monitor地址，才可以使用仪表盘功能。 操作步骤 步骤 1 登录ServiceStage控制台，选择“微服务引擎 CSE”。 步骤 2 进入微服务引擎页面，选择待操作的微服务引擎，单击“查看控制台”。 未开启安全认证的微服务引擎专享版或微服务引擎专业版，请执行步骤4。 开启安全认证的微服务引擎专享版，请执行步骤3。 步骤 3 在弹出的“安全认证”对话框输入帐号名及密码，单击“确定”。 说明： 首次进入微服务控制台，请输入root帐号名及创建微服务引擎专享版时输入的密码。 创建帐号请参考新增帐号。 步骤 4 在“仪表盘”页面，在下拉列表框选择需要查看的应用，在搜索框输入微服务名称，查询微服务，页面将展示筛选出的微服务的运行指标。 单击“查看示例图”，可以查看运行指标参数含义。 步骤 5 选择排序方式，筛选出的微服务会按照指定方式进行排序。

本节主要介绍设置微服务引擎公网访问 状态“可用”的微服务引擎专享版，绑定公网IP后可提供公网访问微服务引擎专享版的能力。 须知 将未配置安全认证鉴权能力的微服务引擎开放到公网将面临安全风险，增加系统的脆弱性。如：配置、服务信息等数据资产可能会被窃取。 请不要在生产环境和安全要求较高的网络环境中使用该功能。 开启公网访问 1、进入微服务引擎页面，单击左侧菜单栏的“引擎列表”。 2、单击待开启公网访问的微服务引擎名称，进入微服务引擎的“基本信息”页面。 3、单击并开启“公网访问”开关。 4、单击“弹性IP地址”后的下拉框。在下拉框中选择可用弹性IP，单击下拉框后侧的 “√”。 若下拉框中无可用弹性IP，请单击“创建弹性IP”，根据界面提示创建。 关闭公网访问 1、进入微服务引擎页面，单击左侧菜单栏的“引擎列表”。 2、单击待关闭公网访问的微服务引擎名称，进入微服务引擎的“基本信息”页面。 3、单击并关闭“公网访问”开关。 4、在弹出对话框单击“确定”。

概述 云原生网关的API管理集中控制API的路由、流量和安全。用户可以配置API路由规则、请求处理、认证授权等功能，确保高效、安全的访问。 操作步骤 1. 登录微服务引擎MSE云原生网关管理控制台，选择资源池。 2. 在左侧导航栏，选择云原生网关 > 网关列表，进入对应网关实例的控制台。 3. 在左侧导航栏，选择API托管 > API列表。 创建API API的创建过程分为四个步骤： 1、基本信息 分组：API所属的分组，创建后不可修改。 API名称：可填写API的业务含义。 安全认证：选择API的安全认证方式，开启应用授权后，只有授权的应用才能访问该API。 防重放攻击：开启后，请求头必须包含xcatimestamp和xcanonce参数。 2、定义API请求 请求路径（Path）：API的访问路径。如果分组设置了BasePath，API的最终访问路径将为BasePath+Path。创建后不可修改。 请求方法（HTTP Method）：指定API的请求方式。创建后不可修改。 入参请求模式：支持三种模式，入参映射（过滤未知参数）、入参映射（透传未知参数）、入参透传。 入参定义：支持在query、header、path中定义参数。如果在path中定义了参数，必须确保该参数包含在Path中。 3、定义后端服务 后端服务：负责处理请求的后端服务。 后端请求路径（Path）：网关转发请求到后端服务的路径。如果在Path中定义了参数，后端请求路径中必须包含相应参数。 请求方法（HTTP Method）：指定请求后端服务的方式。 后端超时：设置请求后端服务的超时时间。 后端服务参数配置：将请求的入参与后端服务的入参一一对应，支持修改请求参数名。 常量参数：可以添加常量参数，并透传到后端服务。 系统参数配置：支持添加系统参数，并透传到后端服务。 4、定义返回结果 这里设置的API返回结果，仅用于生产文档，不会对API的请求、响应产生影响。

本节主要介绍管理微服务引擎专享版安全认证 同一个微服务引擎可能会有多个用户共同使用，而不同的用户根据其责任和权限，需要具备不同的微服务引擎访问和操作权限。开启了“安全认证”的微服务引擎专享版，根据用户接入引擎使用的帐号所关联的角色，赋予该用户不同的微服务引擎访问和操作权限。 安全认证具体内容，请参考系统管理。 您可根据实际业务需要，对微服务引擎专享版执行开启或关闭安全认证操作： 开启安全认证 未开启安全认证且状态可用的微服务引擎专享版，根据实际业务需要，可开启安全认证。 开启安全认证后，接入该引擎的微服务组件如果没有配置安全认证参数，或者微服务组件配置的安全认证帐号和密码不正确，会导致该微服务组件心跳失败，服务被迫下线。 关闭安全认证 已开启安全认证且状态可用的微服务引擎专享版，根据实际业务需要，可关闭安全认证。 关闭安全认证后，无论接入该引擎的微服务组件是否配置了安全认证参数，微服务组件的正常业务功能不受影响。 开启安全认证 1、登录ServiceStage控制台，选择“微服务引擎 CSE”。 2、选择待操作的微服务引擎，单击引擎名称，进入引擎“基本信息”页面。 3、在“安全”区域，开启安全认证开关。 如果引擎版本低于1.2.0，执行步骤4。 如果引擎版本为1.2.0及以上版本，执行步骤5。 4、升级引擎至1.2.0或以上版本。 单击“升级引擎至新版本”。 选择“升级后版本”，查看版本说明，根据需要决定是否升级到该版本后，单击“确定”。 等待升级成功后，单击“返回微服务引擎”。 选择刚升级成功的微服务引擎，单击引擎名称，进入引擎“基本信息”页面。 在“安全”区域，开启安全认证开关。 5、在微服务引擎控制台的“系统管理”页面，开启安全认证。 首次开启安全认证，单击“去开启安全认证”。 需先创建root帐号。输入root帐号的“密码”和“确认密码”，单击“立即创建”。 再次开启安全认证，单击“开启安全认证”。 输入引擎中已关联了admin角色的帐号名称及其密码。 6、（可选）参考角色管理，根据业务需要，创建角色。 7、（可选）参考账号管理，根据业务需要，创建帐号。 8、在微服务引擎控制台的“系统管理”页面，单击“开启安全认证”。 9、根据提示确认已经完成所有配置后，勾选“确保已配置”。 10、单击“确定”。 等待微服务引擎更新完成，引擎状态由“配置中”变为“可用”，开启安全认证成功。

本节主要介绍设置微服务引擎专享版公网访问 状态“可用”的微服务引擎专享版，绑定公网IP后可提供公网访问微服务引擎专享版的能力。 注意 未开启安全认证的微服务引擎无认证鉴权能力，开放到公网面临安全风险，增加系统的脆弱性。如：配置、服务信息等数据资产可能会被窃取。 请不要在生产环境和安全要求较高的网络环境中使用该功能。 开启公网访问 1、登录ServiceStage控制台，选择“微服务引擎 CSE”。 2、单击待开启公网访问的微服务引擎名称，进入微服务引擎的“基本信息”页面。 3、开启“公网访问”开关，在弹出的对话框勾选“我已知晓安全风险”，单击“确定”。 4、单击“弹性IP地址”后的下拉框。在下拉框中选择可用弹性IP，单击下拉框后侧的“√”。 若下拉框中无可用弹性IP，请单击“创建弹性IP”，根据界面提示创建。 关闭公网访问 1、登录ServiceStage控制台，选择“微服务引擎 CSE”。 2、单击待关闭公网访问的微服务引擎名称，进入微服务引擎的“基本信息”页面。 3、关闭“公网访问”开关。 4、在弹出对话框单击“确定”。

本章节介绍微服务云应用平台K8s环境管理最佳实践 概述 在服务开发、服务上线前，您需要创建一个环境。一个环境可以导入云容器引擎、ECS集群、注册配置中心、云原生网关、关系数据库、分布式缓存等资源。 新增环境 1.左侧导航栏，选择环境管理，在环境列表左上方点击创建环境按钮。 2.选择资源池、VPC等信息，VPC需选择云容器引擎、注册配置中心等资源所在的VPC，否则在导入资源时会无法选到对应的资源。 3.点击保存按钮，会弹出授权微服务云应用平台创建VPCE的弹窗，VPCE为打通网络组件，需授权创建才能保证应用功能正常。 环境详情 1.左侧导航栏，选择环境管理。 2.点击环境名称，进入到环境详情页面。 3.在环境详情页面展示了VPC、可用区、应用实例数、资源数、资源列表、部署单元等信息。 资源列表 资源列表展示了已导入环境的资源信息，点击资源ID可以跳转到对于资源的详情页面，查看资源的详细信息。 未导入的资源可以点击导入按钮，将资源导入，导入资源需要与当前环境VPC一致，才可在导入列表展示。导入确定后可通过导入状态查看是否导入成功，对于导入失败的资源可以点击重试按钮进行重试。也可通过日志按钮查看导入日志，分析失败原因。 已导入资源如果已退订或是不在需要使用，可通过移除按钮进行移除。 部署单元 部署单元界面展示了可用区与部署单元的对应关系，默认情况下1个可用区下只有1个部署单元，可通过添加部署单元按钮在可用区下新增部署单元。也可通过编辑部署按钮单元删除部署单元。在发布阶段选择部署单元进行发布。在对应用进行调度时，会将应用调度到部署单元对应的可用区节点上。 环境删除 1.左侧导航栏，选择环境管理。 2.在环境列表操作栏，点击删除按钮删除环境。 3.删除环境需要输环境编码确认删除。删除环境之前需要先删除环境下的部署单元和移除导入环境的资源，否则无法删除环境。

恢复备份数据 注意 恢复备份数据会使用备份的历史数据覆盖微服务引擎当前数据，可能导致微服务、服务实例错乱，动态配置丢失等问题，请谨慎操作！ 1、进入微服务引擎页面，单击左侧菜单栏的“引擎列表”。 2、单击专享版的引擎名称，进入微服务引擎的详细页面。 3、单击“备份与恢复”页签。 4、单击指定备份数据后面“操作”列下的“恢复”按钮。 5、勾选“我已阅读并充分了解该风险”，然后单击“确定”进行恢复备份数据。 删除备份数据 1、进入微服务引擎页面，单击左侧菜单栏的“引擎列表”。 2、单击专享版的引擎名称，进入微服务引擎的详细页面。 3、单击“备份与恢复”页签。 4、单击指定备份数据后面“操作”列下的“删除”按钮。 5、在弹出对话框输入“DELETE”确认删除备份，单击“确定”。

本节主要介绍升级微服务引擎 创建微服务引擎时，使用的是当前最新的引擎版本。当后续再发布新版本的引擎时，用户可以选择升级引擎版本。 注意 1. 仅微服务引擎专享版支持升级引擎版本。升级后，不支持版本回退。 2. 仅支持版本内升级，不支持跨版本升级。 注意事项 升级过程中，高可用和非高可用对外表现不同： 高可用版本：支持两个实例滚动升级，服务不中断。但是可能存在两个接入地址中一个不可用的情况，从而导致该实例不可用，需要支持快速切换到另外一个可用实例。当前，ServiceComb SDK、Go Chassis和Mesher都支持快速切换实例。如果是调用服务注册中心、配置中心接口来进行注册发现的，需要实现实例快速切换。 非高可用版本：非高可用引擎只有一个服务实例，升级过程中服务会中断，导致不能进行服务注册、服务发现和配置变更。需要评估会不会对业务产生影响。ServiceComb SDK、Go Chassis和Mesher都做了可靠性增强，断服过程中，客户端会有缓存。如果查到了空实例，会继续使用本地缓存。如果是调用服务注册中心、配置中心接口来进行注册发现的，需要使用缓存降级。 操作步骤 1、进入微服务引擎页面，单击左侧菜单栏的“引擎列表”。 2、选择待升级的微服务引擎，单击 ，选择“升级”。 3、选择“升级后版本”，查看版本说明，根据需要决定是否升级。 4、单击“确定”，进行升级。 如果升级失败，可单击“重试”，再次进行升级。

概述 网关响应是指云原生网关在接收到后端服务的响应后，依据用户配置的响应规则对响应内容进行处理，并将处理后的结果返回给客户端。用户可以在API分组中配置网关响应，启用后，该响应规则会对分组内的所有API生效。 操作步骤 1. 登录微服务引擎MSE云原生网关管理控制台，选择资源池。 2. 在左侧导航栏，选择云原生网关 > 网关列表，进入对应网关实例的控制台。 3. 在左侧导航栏，选择API托管 > 分组管理，进入要查看的API分组详情，即可看到网关响应模块。 新增网关响应 点击网关响应模块内的新增按钮，即可进入网关响应新增弹窗。支持基于模版创建和自定义创建两种方式。响应编码支持200598，每个分组下，同一个响应编码只能添加一个响应规则。 响应状态码 默认情况下，新建的响应规则会保留后端服务返回的原始响应状态码。如果需要修改响应状态码，可以通过编辑响应规则并填入新的状态码。例如，在413的响应规则中填入500，则客户端接收到的所有413响应都会被替换为500状态码。 响应头 默认情况下，新建的响应规则不会处理响应头。如果需要修改，可以编辑响应规则并添加对响应头的处理逻辑。响应头的处理支持两种操作方式：设置和删除。 · 设置 ：若响应头不存在则新增，若已存在则覆盖。 · 删除 ：用于移除指定的响应头。 参数值可以是常量、系统参数，或两者的组合。系统参数可以从预定义列表中选择，也可以手动输入，使用${} 进行包裹。当匹配到该系统参数时，会自动替换为对应的系统变量值。

恢复备份数据 须知： 备份数据恢复会使用备份的历史数据覆盖微服务引擎当前数据，可能导致微服务、服务实例错乱，动态配置丢失等问题，请谨慎操作！ 步骤 1 登录ServiceStage控制台，选择“微服务引擎 CSE”。 步骤 2 单击专享版的微服务引擎名称，进入微服务引擎的“基本信息”页面。 步骤 3 选择“备份与恢复”页签，单击指定备份数据后面“操作”列下的“恢复”。 步骤 4 勾选“我已阅读并充分了解该风险”，单击“确定”，恢复备份数据。 单击“恢复记录”，可查看恢复状态。

本章节介绍 微服务治理中心服务查询功能 概述 接入微服务治理中心以后，可以在控制台查看SpringCloud和Dubbo应用的服务列表和服务详情。其中服务是指注册到注册中心的SpringCloud和Dubbo服务，应用是指启动的实体。 查看服务列表 登录微服务治理中心控制台，在左侧导航栏选择微服务治理中心>服务查询，在服务查询页面，可通过筛选SpringCloud或Dubbo选项，来选择查看目标服务列表，列表展示服务名称，应用名，实例数。 服务名称：指注册到注册中心的SpringCloud和Dubbo服务的服务名。 应用名：指通过启动参数mse.appName设置的应用名称。 查看服务详情 在服务列表页面单击服务名称，可以查看服务信息、服务调用关系、接口元数据。 如果服务是SpringCloud服务，包含如下信息： 基本信息 ：包含服务名称、服务类型、应用名称。 服务调用关系 ：包含提供者自身的地址列表和消费者的地址列表。服务提供者展示IP和端口信息，服务消费者展示IP和应用名称信息。 接口元数据 ：包含所属类、请求方法、请求路径、方法名和参数列表。 如果服务是Dubbo服务，包含如下信息： 基本信息 ：包含服务名称、服务类型、应用名称。 服务调用关系 ：包含提供者自身的地址列表和消费者的地址列表。服务提供者展示IP和端口信息，服务消费者展示IP和应用名称信息。 接口元数据 ：包含方法名、参数列表和返回数据。

如果在注册配置中心中创建多个实例，服务之间可以相互调用吗？ 购买MSE时需要选择VPC ID，说明只能在该VPC内访问相应的MSE实例。如果多个VPC之间可以相互访问，则MSE也可以跨VPC调用。 注册配置中心实例类型买错了，怎么退掉重新购买？ 如果您的实例是按需付费模式，则直接退订即可。如果您的实例是包周期模式，则需要退费。

概述 API分组支持绑定域名。绑定域名后，可通过该域名访问分组下的API，但前提是该域名需指向该云原生网关实例。 操作步骤 1. 登录微服务引擎MSE云原生网关管理控制台，选择资源池。 2. 在左侧导航栏，选择云原生网关 > 网关列表，进入对应网关实例的控制台。 3. 在左侧导航栏，选择API托管 > 分组管理。 绑定域名 点击对应分组右侧省略号中的绑定域名，即可进入绑定域名弹窗。也可以在分组详情页中，点击域名模块的修改按钮进入。 云原生网关的API支持多环境隔离，提供两种路由方式：请求头路由环境和域名路由环境。两种方式可独立配置，也可同时使用。 请求头路由环境 ：启用后，通过在请求头中传入 XCaStagePROD/TEST/DEV，即可将请求路由到相应的环境。 域名路由环境 ：绑定域名到特定环境后，可通过该域名访问API，网关会自动将请求路由至对应的环境。 > 绑定域名也存在一定的约束： > > 基于请求头部区分环境时，每个环境可以不关联域名或者关联相同的域名； > 不基于请求头部区分环境时，每个环境必须关联至少一个域名且域名不能有重复； > 同一个分组最多支持5个域名 > 基于请求头部区分环境时，使用XCaStage请求头确定环境。其中环境名称分别为：生产PROD；测试TEST；开发DEV

本章节介绍云原生网关的全局插件 概述 全局插件可应用于整个网关实例，对所有API路由都生效，目前云原生网关提供了6种全局插件。 查看全局插件配置列表 操作步骤 1. 进入微服务引擎MSE控制台； 2. 在顶部菜单栏选择资源池； 3. 单击左侧导航栏云原生网关 > 网关列表 ； 4. 您可以在网关列表页单击需要查看的网关实例ID或者 实例名称 ，也可以单击操作列中的管理按钮； 5. 单击左侧导航栏 全局插件 ，可查看全部插件和已启用插件配置列表； 查看全局插件详情 操作步骤 1. 全部插件中展示了目前云原生网关所提供的全局插件列表； 2. 点击插件图标进入插件详情页，展示插件的基本信息，使用引导页面上展示详细的配置属性； 编辑全局插件配置 操作步骤 1. 从全部插件页面点击插件图标进入插件详情页； 2. 插件配置页面展示了当前插件的配置模板； 3. 点击编辑按钮，可对该插件的配置进行编辑修改； 4. 编辑完成后，点击保存按钮，即可保存该插件配置； 5. 若要放弃配置更改，可点击取消按钮； 6. 也可进入已开启插件页面，查看目前正在生效的插件配置，对已开启插件配置进行编辑； 启停全局插件配置

本章节介绍MSAP操作类常见问题 已经订购了云容器引擎，新增环境选择不到云容器引擎？ 选择不到云容器引擎可能有如下两种情况： 1、云容器引擎正在开通中或者开通失败了，需要到开通界面或云容器引擎控制台检查容器状态是否是已开通或运行中。 2、新增环境时选择的VPC和云容器引擎所属VPC不一致，需要到云容器引擎控制台，找到对应集群，进入集群信息界面查看集群所属VPC。再到新增环境界面选择和集群所属VPC一致的VPC。 删除环境不成功，提示：环境下存在部署单元，请先删除部署单元？ 此提示说明要删除的环境下有应用实例、部署单元、导入资源，需要该环境的对应实例、部署单元和导入资源清理之后才能删除环境。 1. 登录微服务云应用控制台，左侧菜单栏选择“环境规划>环境管理”，点击要删除的环境，进入到环境详情。 2. 选择“资源列表”，依次切换该环境下的资源，如果存在该资源，则点击该资源复选框，点击移除，删除资源。 3. 选择“部署单元>编辑单元”，点击对应部署单元删除。 4. 最后回到“环境管理”，选择对应环境，点击右侧删除。

本章节介绍数据库治理中的数据库灰度 概述 数据库灰度在应用层提供灰度环境数据隔离能力。其原理是将数据层的流量路由到数据库影子表中，从而与原有数据进行隔离。结合全链路灰度，可以实现网关到后端服务再到数据库的全链路环境隔离，方便进行灰度环境的服务验证。 使用限制 JDBC驱动支持的版本如下： 框架 限制 详情 Druid Spring Cloud Dalston及以上版本 HikariCP 2.3.13或以上版本 jdk版本 1.8+ 功能入口 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择应用治理。 3. 在应用治理页面的应用卡片页签单击目标应用卡片。 4. 在左侧导航栏选择数据库治理，在数据库灰度页签下可以进行数据库灰度的配置。 步骤一 开启前检查灰度影子表，需要您先开启全链路灰度，针对需要灰度的数据库表进行对应灰度表的创建（灰度表创建规则为默认环境的表名后面加上“标签名”，例如gray环境，默认环境表名为msetable，那么灰度表名为msetablegray）。 如果您只需要针对某些表进行灰度操作，那么您需要配置“需要灰度的数据库表”列表，填入您需要进行灰度访问的数据库表名集合，同时确保您需要灰度的表都有提前创建灰度表。 步骤二 开启数据库灰度。 步骤三 开始验证灰度版本，灰度环境的SQL流量会自动操作对应环境的灰度表。

微服务引擎产品服务协议详情请查看：微服务引擎产品服务协议

微服务引擎服务等级协议详情请查看：微服务引擎服务等级协议

本章节主要介绍角色管理 除了系统中默认提供的两种角色：管理员（admin）和开发者（developer）无法进行操作外，您可以使用该微服务引擎下关联了admin角色权限的“帐号”登录微服务引擎控制台，根据实际的业务需求对角色进行如下表所示的操作。 表 角色管理操作说明 操作 说明 创建角色 根据实际业务需求创建新角色，设置该角色在不同服务组对应的权限动作。 最多可创建100个角色。 编辑角色 根据实际业务需求，修改已创建角色的权限配置。 删除角色 根据实际业务需求，删除不再使用的角色。 说明： 角色删除后无法恢复，请谨慎操作。 删除角色前要先确认该角色没有被帐号关联。取消角色同帐号之间的关联，请参考编辑账号。 查看角色 可按照角色名称的关键字查看该微服务引擎下已创建的角色。 创建角色 步骤 1 登录ServiceStage控制台，选择“微服务引擎 CSE”。 步骤 2 进入微服务引擎页面，选择待创建角色的微服务引擎，单击“查看控制台”。 步骤 3 在弹出的“安全认证”对话框输入该微服务引擎下关联了admin角色权限的帐号名及其密码，单击“确定”。 说明： 首次连接微服务引擎，请输入root帐号名及创建微服务引擎专享版时时输入的密码。 创建帐号请参考新增帐号。 步骤 4 选择“系统管理 > 角色管理”，单击“创建角色”。 步骤 5 输入新角色名称。 说明： 角色创建后，角色名称不可修改。 步骤 6 对权限进行配置。 1. 设置“服务组” − 选择“全部服务” 可以对该微服务引擎的所有微服务资源实施相应的权限动作。 − 选择“自定义服务组”，可按照下表进行设置。 表 自定义服务组操作 操作名称 操作说明 :: 新增匹配规则 单击“添加服务组匹配规则”，根据实际业务需要，选择“应用”、“环境”、“服务”三个参数值来匹配规则过滤该角色可以实施权限动作的微服务。 说明 应用名称、环境名称和服务名称是微服务的三个参数： 如果单条匹配规则只设置了一个参数，则角色对与该参数值相匹配的微服务有操作权限。 例如添加匹配规则“环境:production”，那么该角色只对环境名称是“production”的微服务有操作权限。 如果单条匹配规则设置了多于一个参数，则角色对与所有参数值都相匹配的微服务有操作权限。 例如添加匹配规则“环境:production”“应用:abc”，那么该角色对环境名称是“production”且应用名称是“abc”的微服务有操作权限。 在启用自动发现的情况下，微服务会通过注册中心查询注册中心、配置中心、仪表盘等服务的实例地址。对微服务授予查询权限时，需要包含应用default的权限，添加匹配规则“应用:default”。 设置微服务匹配规则后，单击“确定”。 编辑匹配规则 单击待编辑的匹配规则后的“编辑图标”，即可根据实际业务需要，重新设置该条匹配规则的“服务组”和“权限动作”。 重新设置服务组匹配规则后，单击“确定”。 删除匹配规则 单击待删除的匹配规则后的“删除图标”，即可根据实际业务需要，删除该条服务组匹配规则。 自定义服务组最多可以同时设置20条微服务匹配规则。 当自定义服务组设置了多条匹配规则时，只要微服务满足其中任意一条匹配规则，角色就对该微服务有操作权限。 2. 设置“权限动作” 按照实际的业务需求，设置角色对选择的服务组可实施的权限动作，可以勾选多个。 − 全选：对该服务组资源可实施增加、删除、修改和查询四种动作。 − 增加：对该服务组资源可实施增加的动作。 − 删除：对该服务组资源可实施删除的动作。 说明： 如果只勾选了删除，将无法通过界面对服务组资源进行删除，必须同时勾选查询。 − 修改：对该服务组资源可实施修改的动作。 说明： 如果只勾选了修改，将无法通过界面对服务组资源进行修改操作，必须同时勾选查询。 − 查询：对该服务组资源可实施查询的动作。 步骤 7 单击“创建”，创建角色。

云应用引擎 CAE（Cloud App Engine）是面向应用的 Serverless PaaS 平台，提供成本更优、效率更高的一站式应用托管方案，容器新手也可以体验 Serverless、K8s 和微服务。您可以通过不同场景，对比 CAE 与开源自建产品在系统搭建、成本、功能管理、弹性效率和监控诊断等方面的优势。 基础场景 对比项 开源自建 SC/Dubbo + IaaS 集群 开源自建 SC/Dubbo +自建 K8s 集群 CAE IaaS购买和系统搭建 需要。 需要。 不需要。CAE 内置 K8s 集群底座和微服务框架。 运维成本 需要。 需要。 不需要。CAE 免运维。 硬件成本 按峰值固定保有包年IaaS，资源利用率低，有闲置浪费。 按峰值固定保有包年IaaS，资源利用率低，有闲置浪费。 按需使用，按量付费，无闲置浪费。 应用管理 纯黑屏操作，效率低且易出错。 自行集成各个云服务，自研发布策略用于规避停机升级风险。 Kubectl或K8s Dashboard操作，门槛高。 自行集成各个云服务，自研发布策略规避停机升级风险。 白屏化操作，根据应用健康自动调配流量。 可灰度、可观测和可回滚。 提供镜像仓库和代码源等。 弹性效率 分钟级。 分钟级。 秒级。 使用体验 创建应用前置步骤多（需购买机器、创建集群和初始化集群等）。 自行对接各个云服务，集成体验差。 创建应用前置步骤多（需购买机器、创建集群和初始化集群等）。 自行对接各个云服务，集成体验差。 直接创建应用，流程极简。 无缝对接各个云服务，一站式 PaaS 体验。

微服务云应用平台系统权限策略 默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略，才能使得用户组中的用户获得策略定义的权限，这一过程称为授权。授权后，用户就可以基于策略内的权限对微服务云应用平台进行操作。为方便使用，微服务云应用平台已内置以下五种系统策略： 策略名称 策略描述 微服务云应用平台MSAP系统管理员 微服务云应用平台MSAP系统管理员策略，拥有MSAP系统所有权限（适用于一类节点资源池） 微服务云应用平台MSAP资源管理员 微服务云应用平台MSAP系统资源管理员策略，负责与环境、集群相关的管理员权限（适用于一类节点资源池） 微服务云应用平台MSAP资源运维人员 微服务云应用平台MSAP系统资源运维策略，负责与环境、集群相关的运维权限（适用于一类节点资源池） 微服务云应用平台MSAP应用管理员 微服务云应用平台MSAP系统应用管理员策略，负责与应用相关的管理员权限（适用于一类节点资源池） 微服务云应用平台MSAP应用运维人员 微服务云应用平台MSAP系统应用运维策略，负责与应用相关的运维权限（适用于一类节点资源池） 注意 未授权微服务云应用平台策略的子账号是不能正常使用微服务云应用平台系统功能，请参考主账号给子账号授权IAM权限策略流程。 每个策略所包含的微服务云应用平台权限列表如下表格所示，其中，“√”表示支持，“x”表示不支持。 权限 微服务云应用平台MSAP系统管理员 微服务云应用平台MSAP资源管理员 微服务云应用平台MSAP资源运维人员 微服务云应用平台MSAP应用管理员 微服务云应用平台MSAP应用运维人员 管理企业项目 √ √ √ √ √ 查看环境 √ √ √ √ √ 创建环境 √ √ x x x 更新环境 √ √ √ x x 删除环境 √ √ √ x x 查看集群 √ √ √ √ √ 管理集群 √ √ √ √ √ 查看项目 √ √ √ √ √ 创建项目 √ √ x x x 更新项目 √ √ √ x x 删除项目 √ √ √ x x 查看应用 √ √ √ √ √ 管理应用 √ x x √ √ 查看应用分组 √ √ √ √ √ 管理应用分组 √ √ √ √ √ 查看技术栈 √ √ √ √ √ 管理技术栈 √ √ √ √ √ 查看制品库 √ √ √ √ √ 管理制品库 √ x x √ √ 查看应用实例 √ √ √ √ √ 创建应用实例 √ x x √ x 管理应用实例 √ x x √ √ 删除应用实例 √ x x √ √ 配置应用实例 √ √ √ √ √ 查看Kubernetes配置 √ √ √ √ √ 配置Kubernetes √ √ √ √ √ 查看Ingress路由 √ √ √ √ √ 管理Ingress路由 √ √ √ √ √ 批量运维 √ √ √ √ √ 查看微服务配置 √ √ √ √ √ 管理微服务配置 √ √ x √ √ 查看全链路流量控制 √ √ √ √ √ 管理全链路流量控制 √ x x √ √ 主子账号 √ x x x x 查看服务连接 √ √ √ √ √ 管理服务连接 √ √ √ √ √ 审计日志 √ x x x x

修改密码 步骤 1 登录ServiceStage控制台，选择“微服务引擎 CSE”。 步骤 2 进入微服务引擎页面，选择待修改帐号密码的微服务引擎，单击“查看控制台”。 步骤 3 在弹出的“安全认证”对话框输入帐号名及其密码，单击“确定”。 说明 ： 首次连接微服务引擎，请输入root帐号名及创建微服务引擎专享版时输入的密码。 连接微服务引擎的帐号未关联admin角色权限，仅可修改当前登录帐号的密码。 连接微服务引擎的帐号关联了admin角色权限，可修改该微服务引擎下所有帐号的密码。 创建帐号请参考新增账号。 步骤 4 选择“系统管理 > 帐号管理 ”，选择登录该微服务引擎的帐号名，单击“操作”列的“修改密码”。 1. 输入“原密码”、“新密码”和“确认密码”。 2. 查看提示信息确认需要修改密码后，勾选“我已确认知晓”。 说明： 也可单击“系统管理”页面右上角的“修改密码”，修改当前登录帐号的密码。 步骤 5 单击“保存”，完成密码修改。 重置密码 步骤 1 登录ServiceStage控制台，选择“微服务引擎 CSE”。 步骤 2 进入微服务引擎页面，选择待重置帐号密码的微服务引擎，单击“查看控制台”。 步骤 3 在弹出的“安全认证”对话框输入该微服务引擎下关联了admin角色权限的帐号名及其密码，单击“确定”。 说明 ： 首次连接微服务引擎，请输入root帐号名及创建微服务引擎专享版时输入的密码。 创建帐号请参考新增账号。 步骤 4 选择“系统管理 > 帐号管理 ”，选择待重置密码的帐号名，单击“操作”列的“重置密码”。 1. 输入“新密码”和“确认密码”。 2. 查看提示信息确认需要重置密码后，勾选“我已确认知晓”。 步骤 5 单击“保存”，完成密码重置。

启动本地服务中心 1、进入本地开发工具，根据具体环境下的操作系统、CPU架构，下载对应版本的本地开发工具压缩包到本地并解压缩到安装目录。 2、启动CSE。 Linux/Unix系统，进入安装根目录，执行如下命令： nohup sh start.sh >/dev/null 2>&1 & Windows系统，进入安装根目录，双击cse.exe文件启动。 3、停止CSE。 Linux/Unix系统，进入安装根目录，执行如下命令： sh stop.sh Windows系统，关闭命令行窗口。 mesher性能损耗是多少？ 服务网格技术实际利用了网络流量劫持的方式来管理服务间流量，除了mesher本身内部的逻辑处理会耗时之外，还会引起额外的用户态和内核态间转换（CPU会有额外消耗），而前者相对于后者性能影响极小，因此性能损耗基本取决于网络中传输的payload大小。以http协议举例，影响传输速度的就是header、body等内容的大小。mesher一次端到端调用中的延迟为1ms，一个典型的用户测试过自己真实的业务调用，加上mesher后，延迟高了4ms，在用户可接受范围内。 连接服务中心提示“Version validate failed”如何解决？ 原因是使用了新版本的SDK，却连接服务中心老版本的SDK。此时应检查服务中心的版本。可以从官网下载最新版本的服务中心，或者从ServiceComb官网下载最新版本的服务中心。 连接服务中心提示“Not enough quota”如何解决? 原因是没有足够的额度增加服务实例。此时应登录云控制台，在微服务引擎页面，可以看到实例个数的额度。如果发现页面有额度，需要检查下代码配置的服务中心地址和区域信息。