华为云用户手册

背景信息 在购买AstroFlow后，如果发现当前规格套餐无法满足业务需求，您可以变更套餐规格。当需要变更到高规格套餐时，需补齐版本差价，例如您购买的套餐为一年，则剩余服务周期按照剩余天数（不含闰年的2.29号）/365 进行计算（变更当天不算） ，续费时按照变更后的版本进行续费。 升级版本费用 = 升级后版本价格 * 剩余周期 - 未升级版本价格 * 剩余周期 剩余周期计算：按照实际剩余有效期进行换算 示例：2023/11/1客户购买了3年的AstroFlow，有效期截止到2026/11/1，客户在2024/5/1发生变更版本，则剩余周期=2024年剩余周期+2025年剩余周期+2026年剩余周期=244/365+1+305/365=2.50（年）。

计费示例（无扩容包） 假设您在2023年11月01日，购买了AstroFlow专业版有效期1年，并在到期前手动续费1年，则： 第一个计费周期为：2023/11/01 15:50:04 ~ 2024/11/01 23:59:59 第二个计费周期为：2024/11/01 23:59:59 ~ 2025/11/01 23:59:59 续费时需支付的费用为AstroFlow规格套餐包年/包月的费用（费用以官网实际费用为准）。

计费说明 根据您选择的版本规格进行计费。当购买专业版和企业版套餐时，计费项还包括人数扩容包和资源扩容包。如您需要快速了解Astro工作流服务的具体价格，请参见Astro工作流价格详情。 表1 AstroFlow计费项 计费项 计费项说明 适用的计费模式 计费公式 套餐规格 AstroFlow提供了不同的规格套餐，请根据自身需求，购买相应的规格套餐。 基础版：满足个人及创业团队的基础需求，用户能够低门槛入门使用该产品。 专业版：满足中大企业搭建复杂业务场景的需求，提供了更多定制和集成的功能。 企业版：满足大企业搭建高性能复杂场景的需求，支持高级流程和表单的设计。 各套餐详细介绍，请参见计费模式。 包年/包月 基础版：免费。 专业版和企业版：套餐版本单价 * 购买时长。 说明： 购买一年套餐享受优化价，例如，购买时长为1年时，实付10个月。 购买时长 购买AstroFlow套餐包的时长。 基础版支持购买1~12个月。 专业版和企业版支持购买1~9个月或者1年。 人数扩容包 AstroFlow移专业版和企业版提供了人数扩容包，请根据业务需求，购买相应数量的扩容包。 人数扩容包（人数扩容50人/单元）：用于新增更多的组织用户数。不可单独购买和退订，专业版和企业版套餐到期后，扩容包将不可使用。 包年/包月 扩容包单价 * 购买时长（以主套餐有效时间折算）。 资源扩容包 AstroFlow专业版及企业版提供了资源扩容包，请根据业务需求，购买相应数量的扩容包。 资源扩容包（总数据调用次数20万/单元/每月）：提供更多的数据调用次数。不可单独购买和退订，专业版和企业版套餐到期后，扩容包将不可使用。 包年/包月 扩容包单价 * 购买时长（以主套餐有效时间折算）。

计费示例（包含扩容包） 假设您在2023年11月01日，购买了AstroFlow专业版有效期1年，同时订购了3个单元的人数扩容包和2个单元的资源扩容包。那么1年的费用计算过程如下： 套餐费用：4980元 * 1年 = 4980元 人数扩容包费用：2016元 * 3单元 * 1年 = 6048元 资源扩容包费用：47760元 * 2单元 * 1年 = 95520元 综上，1年的费用 = 4980 + 6048 + 95520 = 106548元

到期后影响 图1描述了AstroFlow套餐包年/包月的各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期。资源到期而未续费时，将陆续进入宽限期和保留期。 图1 包年/包月AstroFlow套餐生命周期 到期预警 AstroFlow套餐在包年/包月的到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为账号的创建者。 到期后影响 当您包年/包月的AstroFlow套餐到期未续费，首先会进入宽限期，资源状态变为“已过期”。宽限期内您可以正常访问AstroFlow，但以下操作可能会受到限制： 创建表单、应用和流程 组织设置和通讯录管理 连接器的使用和自定义 如果在宽限期内仍未续费AstroFlow套餐，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年/包月AstroFlow执行任何操作。 保留期到期后，若仍未续费，那么超过AstroFlow基础版范围的功能会进入停用状态。

变更配置后对计费的影响 当前包年/包月AstroFlow套餐的规格不能满足您的业务需要时，可以在控制台发起变更规格操作，变更时系统将按照如下规则为您计算变更费用： 套餐版本升级：新套餐版本价格高于老套餐版本价格，此时您需要支付新老版本的差价。 升级版本费用 = 升级后版本价格 * 剩余周期 - 未升级版本价格 * 剩余周期 剩余周期计算示例： 2023/11/1客户购买了3年的AstroFlow，有效期截止到2026/11/1，客户在2024/5/1发生变更，则剩余周期=2024年剩余周期+2025年剩余周期+2026年剩余周期=244/365+1+305/365=2.50（年）。

适用计费项 AstroFlow提供了如下三种不同的规格套餐，供不同规模和管理需求的企业进行选购使用。希望通过合理的功能和服务的组合，为不同需求的客户，提供最合适的产品及服务内容。 基础版：满足个人及创业团队的基础需求，用户能够低门槛入门使用该产品。 专业版：满足中大企业搭建复杂业务场景的需求，提供了更多定制和集成的功能。 企业版：满足大企业搭建高性能复杂场景的需求，支持高级流程和表单的设计。 表1 适用计费项 计费项 说明 套餐规格 套餐规格由组织用户数、应用数、总数据调用次数、存储空间、单表单数据上限、流程和表单高级功能以及业务门户风格定制等组成。AstroFlow套餐规格清单及功能介绍，请参见产品规格差异。

适用场景 Spring Boot、Spring Cloud广泛应用于构建微服务应用。使用ServiceComb引擎托管Spring Cloud应用，主要目的是使用高可靠的商业中间件替换开源组件，对应用系统进行更好地管理和运维，改造过程应尽可能降低对业务逻辑的影响。适用于如下场景： 基于Spring Boot开发的应用系统，不具备微服务基本能力。应用系统通过集成Spring Cloud Huawei，具备服务注册发现、动态配置管理等能力。 基于Spring Cloud开源技术体系开发的应用系统，例如已经采用Eureka实现注册发现、采用Nacos实现动态配置，应用系统通过集成Spring Cloud Huawei，使用高可靠的商业中间件替换开源中间件，降低维护成本。 基于Spring Cloud其他开发体系，例如Spring Cloud Alibaba、Spring Cloud Azure等构建的云原生应用，使用Spring Cloud Huawei迁移到华为云运行。

约束限制 Nacos对Eureka的兼容，主要是兼容Eureka服务端侧的API，将服务侧注册的客户端实例信息进行保存与刷新，因此如果您仅使用Eureka作为注册中心，那么Nacos的诸多特性如命名空间和配置管理是不能使用的。 使用Eureka作为客户端，仅能在Nacos的“服务管理”中进行查阅，Eureka服务均使用Nacos的默认属性进行展示，即： 默认命名空间：public。 默认分组名称：DEFAULT_GROUP。 在Nacos中在“服务管理”页面创建服务的“保护阈值”设置的值属于Nacos的特性，无法作用于Eureka服务。

前置条件 已创建云容器引擎（CCE），创建CCE请参考创建CCE集群。 CCE集群版本需要大于等于1.15。 应用的基础镜像中，需要安装JDK ( 版本为1.8及以上版本 )。 已安装kubectl命令，安装kubectl命令请参考通过kubectl连接集群中相关操作。 已创建ServiceComb引擎实例，详情请参考创建ServiceComb引擎。 CCE集群与ServiceComb引擎处于相同的VPC网络下。 给Sermant Injector预留200m左右的cpu资源和300Mi左右的memory资源。 Sermant Injector版本要求1.0.11及以上，Sermant Agent镜像版本要求1.0.9及以上。

概述 CS E提供Sermant Agent，支持Dubbo应用无需任何修改接入ServiceComb引擎，当前已支持应用注册发现、标签路由功能。 Sermant Agent是基于Sermant开源社区构建的、用于CSE微服务治理场景的Agent。 Sermant Agent基于Java Agent技术实现，应用通过Sermant Agent可实现无代理、非侵入方式接入ServiceComb引擎，并获得标签路由能力。 此功能目前处于公测阶段，当前仅在华东-上海一支持。 父主题： 通过Sermant Agent托管Dubbo应用

部署Spring Cloud应用 打包Sermant-examples。 在“Sermant-examples”根目录下，打开cmd命令，执行mvn clean package命令，对项目进行打包编译。编译成功后，获取下表中的两个软件包。 表1 软件包列表 软件包所在目录 软件包名称 说明 Sermant-examples/registry-demo/spring-cloud-registry-demo/spring-cloud-registry-consumer/target spring-cloud-registry-consumer.jar 服务消费者 Sermant-examples/registry-demo/spring-cloud-registry-demo/spring-cloud-registry-provider/target spring-cloud-registry-provider.jar 服务生产者 把spring-cloud-registry-consumer.jar复制到“Sermant-examples/registry-demo/spring-cloud-registry-demo/deployment/images/consumer”中。 把spring-cloud-registry-provider.jar复制到“Sermant-examples/registry-demo/spring-cloud-registry-demo/deployment/images/provider”中。 制作镜像。 登录已安装kubectl命令且已部署Sermant Injector的CCE集群中的节点。 把“Sermant-examples/registry-demo/spring-cloud-registry-demo”中的“deployment”文件夹上传至已登录的CCE集群中的节点上。 请参考使用容器引擎客户端上传镜像制作docker镜像，其中，使用到的Dockerfile请参考“Sermant-examples/registry-demo/spring-cloud-registry-demo/deployment/images/consumer”与“Sermant-examples/registry-demo/spring-cloud-registry-demo/deployment/images/provider”目录下的Dockerfile文件按需修改。 部署spring-cloud-registry-consumer.yaml与spring-cloud-registry-provider.yaml。 修改镜像名。 将已上传deployment文件夹到CCE集群中的节点中的“deployment/k8s/spring-cloud-registry-consumer.yaml“与“deployment/k8s/spring-cloud-registry-provider.yaml“中的镜像名修改为您所制作的镜像名。 在已上传deployment文件夹到CCE集群中的节点中的“deployment/k8s“目录下，执行如下命令部署spring-cloud-registry-consumer.yaml与spring-cloud-registry-provider.yaml： kubectl create -f spring-cloud-registry-consumer.yaml kubectl create -f spring-cloud-registry-provider.yaml 若需配置APP名称（默认default）、版本（形如a.b.c的格式，其中a、b、c均为数字，默认为1.0.0）请在yaml中增加SERVICE_META_APPLICATION与SERVICE_META_VERSION环境变量进行配置。如下所示： 验证应用接入ServiceComb引擎。 参考查看微服务列表查看应用（服务名为spring-cloud-registry-consumer与spring-cloud-registry-provider）是否已接入ServiceComb引擎。

前提条件 已创建云容器引擎（CCE），创建CCE请参考创建CCE集群。 CCE集群版本需要大于等于1.15。 已安装kubectl命令，安装kubectl命令请参考通过kubectl连接集群中相关操作。 已创建ServiceComb引擎实例，详情请参考创建ServiceComb引擎。 CCE与ServiceComb引擎处于相同的VPC网络下。 下载Sermant-examples到本地并解压。 本地编译构建打包机器环境已安装了Java JDK、Maven，并且能够访问Maven中央库。 已在CCE集群上部署Sermant Injector，详情请参考通过模板管理页面部署Sermant Injector将应用接入ServiceComb引擎或者通过Helm客户端部署Sermant Injector。

前置条件 已创建云容器引擎（CCE），创建CCE请参考创建CCE集群。 CCE集群版本需要大于等于1.15。 应用的基础镜像中，需要安装JDK ( 版本为1.8及以上版本 )。 已安装kubectl命令，安装kubectl命令请参考通过kubectl连接集群中相关操作。 已创建ServiceComb引擎实例，详情请参考创建ServiceComb引擎。 CCE集群与ServiceComb引擎处于相同的VPC网络下。 给Sermant Injector预留200m左右的cpu资源和300Mi左右的memory资源。 Sermant Injector版本要求1.0.11及以上，Sermant Agent镜像版本要求1.0.9及以上。

标签路由 标签路由版本支持： Spring Cloud Spring Boot Spring Cloud Openfeign RestTemplate Spring Cloud Loadbalancer Spring Cloud Netflix Ribbon Spring Cloud Gateway Spring Cloud Netflix Zuul Edgware.SR2+ 1.5.x 1.4.7.RELEASE 4.3.6.RELEASE - 1.4.7.RELEASE - 1.4.7.RELEASE Finchley.x 2.0.x 2.0.x 5.0.x - 2.0.x - 2.0.x Greenwich.x 2.1.x 2.1.x 5.1.x - 2.1.x - 2.1.x Hoxton.x 2.2.x、2.3.x 2.2.x 5.2.x 2.2.5.RELEASE+ 2.2.x 2.2.x 2.2.x 2020.0.x 2.4.x、2.5.x 3.0.x 5.3.x 3.0.x - 3.0.x - 2021.0.0 2.6.x 3.1.x 5.3.x 3.1.x - 3.1.x -

配置管理 Spring Boot Nacos Config Zookeeper Config 1.5.0.RELEASE - 2.6.2 1.5.0.RELEASE+ 1.2.0.RELEASE+ Nacos Config为maven依赖的spring-cloud-starter-alibaba-nacos-config。 Zookeeper Config为maven依赖的spring-cloud-starter-zookeeper-config。 配置管理能力需配合注解@RefreshScope、@Value、@ConfigurationProperties使用。

概述 CSE提供Sermant Agent，支持Spring Cloud应用无需任何修改接入ServiceComb引擎，当前已支持应用注册发现、配置、优雅上下线、标签路由等功能。 此功能目前处于公测阶段，当前仅在华东-上海一支持。 Sermant Agent是基于Sermant开源社区构建的、用于CSE微服务治理场景的Agent。 Sermant Agent基于Java Agent技术实现，应用通过Sermant Agent可实现无代理、非侵入方式接入CSE。 父主题： 通过Sermant Agent托管Spring Cloud应用

功能介绍 随着istio服务网格的发展，越来越多的应用都会接入服务网格，Sermant Agent提供了一种能让Spring Cloud应用也能访问服务网格中的应用的解决方案。 Spring Cloud应用访问istio应用的部署图如下： istio应用需要注册到istio中，不限制语言，Spring Cloud应用不必注册到istio中，Spring Cloud应用部署的环境可以是ECS/CCE/ASM。Spring Cloud应用会通过Sermant Agent进行istio中的服务发现，然后Spring Cloud应用便可以像调用其它Spring Cloud应用一样，通过服务名调用istio中的服务。 此功能目前处于公测阶段，当前仅在华东-上海一支持。 当ServiceComb引擎为2.x版本且未开启安全认证时，支持此功能。 Sermant Injector版本要求1.0.11及以上，Sermant Agent镜像版本要求1.0.9及以上。

设置服务路由策略 配置项：servicecomb.routeRule，配置内容： providerA: | - precedence: 2 match: headers: id: exact: '1' caseInsensitive: false route: - weight: 0 tags: group: base - weight: 100 tags: group: gray - precedence: 1 route: - weight: 100 tags: group: base - weight: 0 tags: group: gray providerB: | - precedence: 2 match: headers: id: exact: '1' caseInsensitive: false route: - weight: 0 tags: group: base - weight: 100 tags: group: gray - precedence: 1 route: - weight: 100 tags: group: base - weight: 0 tags: group: gray 服务路由策略设置说明： 请求头的id参数值精确匹配为1时，consumer的所有请求流量都是从providerA-gray流向providerB-gray。 请求头的id参数值为其他任意值，consumer的所有请求流量都是从providerA流向providerB。

Sermant Agent监听配置范围 Sermant Agent使用CSE作为配置中心时，监听的范围有以下三个： app=default&environment=&service={服务名} app=default&environment= public=default app对应为“应用”值； environment对应为“环境”； service对应为“微服务名称”； public为公共配置。 一般设置为app=default&environment=作为通用路由设置。

前提条件 已创建云容器引擎（CCE），创建CCE请参考创建CCE集群。 CCE集群版本需要大于等于1.15。 已安装kubectl命令，安装kubectl命令请参考通过kubectl连接集群相关操作。 已创建未开启安全认证的ServiceComb引擎实例，详情请参考创建ServiceComb引擎。 本地编译构建打包机器环境已安装了Java JDK、Maven，并且能够访问Maven中央库。 Sermant Agent开源版本要求1.0.6及以上。

操作步骤 为CCE集群安装sermant-injector，请参考CCE部署场景接入指南。 为工作负载（deployment）中的微服务配置版本号或标签。 在下图所示位置为工作负载（deployment）配置环境变量，配置环境变量后，应用注册时，会使用该环境变量进行注册。 apiVersion: app/v1 kind: Deployment metadata: name: dubbo-providerB labels: app: dubbo-providerB spec: replicas: 1 selector: matchLabels: app: dubbo-providerB template: metadata: labels: app: dubbo-providerB sermant-injection: enabled spec: containers: - name: dubbo-providerB image: dubbo-providerB:1.0.0 imagePullPolicy: IfNotPresent env: - name: "SERVICE_META_VERSION" value: "2.0.0" - name: "SERVICE_META_PA RAM ETERS" value: "group:gray" ports: - containerPort: 8004 imagePullSecrets: - name: default-secret 其中： 键SERVICE_META_VERSION，值为服务注册的版本号（如a.b.c的格式，其中a、b、c均为数字），标签应用需要修改为不同于正常应用的版本号。 键SERVICE_META_PARAMETERS，值为服务注册时的自定义标签（形如tag1:value1,tag2:value2），即标签名与标签值以英文冒号分隔，多个标签之间以英文逗号分隔。 当Sermant Agent为1.0.0及以下版本时，使用键为SERVICECOMB_INSTANCE_PROPS。 一般，如果用版本号进行路由，则只需配置SERVICE_META_VERSION，如果用自定义标签进行路由，则只需配置SERVICE_META_PARAMETERS。 为工作负载（deployment）打上标签并重启相关服务。 在下图所示位置为工作负载（deployment）打上标签sermant-injection: enabled。打上标签后，sermant-injector会在Pod重启时自动挂载Sermant Agent，从而通过Sermant Agent注册到CSE上。

下发路由规则配置 下发路由规则配置，详情请参考配置管理。 路由规则说明示例： --- - precedence: 2 # 优先级，数字越大，优先级越高。 match: # 请求匹配规则。0..N个，不配置表示匹配。 headers: # http header匹配 id: # 如果配置了多个header，那么所有的header规则都必须和请求匹配 exact: '1' # 配置策略，等于1，详细配置策略见配置策略表。 caseInsensitive: false # false:不区分大小写（默认）,true:区分大小写。配置为false时，将统一转为大写进行比较 route: # 路由规则 - weight: 20 # 权重值 tags: version: 1.0.0 # 实例标记。满足标记条件的实例放到这一组。 - weight: 80 # 权重值 tags: version: 1.0.1 # 实例标记。满足标记条件的实例放到这一组。 - precedence: 1 route: - weight: 20 tags: group: red - weight: 80 tags: group: green

操作步骤 为CCE集群安装sermant-injector，请参考CCE部署场景接入指南。 为工作负载（deployment）中的微服务配置版本号或标签。 在下图所示位置为工作负载（deployment）配置环境变量，配置环境变量后，应用注册时，会使用该环境变量进行注册。 apiVersion: app/v1 kind: Deployment metadata: name: cloud-providerB labels: app: cloud-providerB spec: replicas: 1 selector: matchLabels: app: cloud-providerB template: metadata: labels: app: cloud-providerB sermant-injection: enabled spec: containers: - name: cloud-providerB image: cloud-providerB:1.0.0 imagePullPolicy: IfNotPresent env: - name: "SERVICE_META_VERSION" value: "2.0.0" - name: "SERVICE_META_PARAMETERS" value: "group:gray" ports: - containerPort: 8004 imagePullSecrets: - name: default-secret 其中： 键SERVICE_META_VERSION，值为服务注册的版本号（如a.b.c的格式，其中a、b、c均为数字），标签应用需要修改为不同于正常应用的版本号。 键SERVICE_META_PARAMETERS，值为服务注册时的自定义标签（形如tag1:value1,tag2:value2），即标签名与标签值以英文冒号分隔，多个标签之间以英文逗号分隔。 当Sermant Agent为1.0.0及以下版本时，使用键为SERVICECOMB_INSTANCE_PROPS。 一般，如果用版本号进行路由，则只需配置SERVICE_META_VERSION，如果用自定义标签进行路由，则只需配置SERVICE_META_PARAMETERS。 为工作负载（deployment）打上标签并重启相关服务。 在下图所示位置为工作负载（deployment）打上标签sermant-injection: enabled。打上标签后，sermant-injector会在Pod重启时自动挂载Sermant Agent，从而通过Sermant Agent注册到CSE上。

版本支持 Spring Cloud Version Spring Boot Version Spring Cloud Openfeign Version RestTemplate Version Spring Cloud Loadbalancer Version Spring Cloud Netflix Ribbon Version Spring Cloud Gateway Version Spring Cloud Netflix Zuul Version Edgware.SR2+ 1.5.x 1.4.3.RELEASE+ 4.3.6.RELEASE+ - 1.4.3.RELEASE+ - 1.4.3.RELEASE+ Finchley.x 2.0.x 2.0.x 5.0.x - 2.0.x - 2.0.x Greenwich.x 2.1.x 2.1.x 5.1.x - 2.1.x - 2.1.x Hoxton.x 2.2.x、2.3.x 2.2.x 5.2.x 2.2.5.RELEASE+ 2.2.x 2.2.x 2.2.x 2020.0.x 2.4.x、2.5.x 3.0.x 5.3.x 3.0.x - 3.0.x - 2021.0.0 2.6.x 3.1.x 5.3.x 3.1.x - 3.1.x - 通过Sermant Agent注册到ServiceComb引擎中的应用可以使用标签路由功能。

（可选）自定义优雅上下线配置 优雅上下线能力默认开启，若需自定义配置，请参考如下方式： 如果方式一与方式二同时配置，将以方式二为准。 方式一： 在启动Spring Cloud应用时通过环境变量或者-D参数的形式进行配置，配置参数如下： 参数项 说明 grace_rule_startDelayTime 注册延迟时间，默认0秒，若大于0，则开启注册延迟。 grace_rule_enableWarmUp 开启优雅上线能力，默认开启。 grace_rule_warmUpTime 优雅上线时间，单位秒，该配置生效需开启优雅上线功能，默认120秒。 grace_rule_enableGraceShutdown 配置优雅下线能力开关， 默认开启。 grace_rule_shutdownWaitTime 下线前的最大等待时间，默认30S。 grace_rule_enableOfflineNotify 开启下线通知，默认开启。 方式二： 通过配置管理进行配置，配置步骤如下： 登录微服务引擎控制台。 单击，选择区域。 选择“ServiceComb引擎”。 单击待操作的ServiceComb引擎。 选择“配置管理”。 单击右上角的“新建配置”进入新建配置页面。 输入“配置项”，命名为sermant.agent.grace。 此处名称固定为该值。 选择“配置范围”，这里以微服务级配置为例，选择您要配置的服务，如下图所示： “配置格式”选择“YAML”，并自定义优雅上下线配置， 如下： rule: startDelayTime: 0 # 注册延迟时间，默认0秒，若大于0，则开启注册延迟。 enableWarmUp: true # 开启优雅上线能力，默认为true（开启），如需关闭，请设置为fasle。 warmUpTime: 120 # 优雅上线时间，单位秒，该配置生效需开启优雅上线功能，默认120秒。 enableGraceShutdown: true # 配置优雅下线能力开关，默认为true（开启），如需关闭，请设置为fasle。 shutdownWaitTime: 30 # 下线前的最大等待时间，默认30S。 enableOfflineNotify: true # 开启下线通知，默认开启。 单击右下角的“立即创建”，然后重启对应服务实例即可。 下发配置时，请去掉注释，否则会导致下发配置失败。

验证优雅上下线能力 验证优雅上线能力。 图1 优雅上线验证部署图 如上图所示，该套nacos应用有nacos-rest-consumer、nacos-rest-provider（两个实例）以及nacos-rest-data服务，其中灰色的实例已关闭开启优雅上线，而绿色实例开启优雅上线功能。 若需关闭预热，请添加环境变量“grace_rule_enableWarmUp=false”进行指定。 而服务nacos-rest-consumer通过接口graceHot进行模拟调用。 下载demo应用并打包。 按照优雅上线验证部署图进行部署并将nacos-rest-provider的其中一个实例开启优雅上线能力。 查看应用是否已全部接入ServiceComb引擎。 参考查看微服务列表查看您的应用是否已接入ServiceComb引擎。 待应用接入ServiceComb引擎后，使用以下脚本invoke-hot.sh模拟调用过程。 #!/bin/bash endpoint=127.0.0.1:31021 url=${endpoint}/graceHot while true do echo `curl -s ${url}` done endpoint为nacos-rest-consumer服务的调用地址，即ip:port。需根据实际nacos-rest-consumer地址进行替换。 查看服务调用情况。 使用脚本stat.sh查看服务调用情况，脚本如下： #!/bin/bash endpoint=127.0.0.1:31021 watch curl ${endpoint}/stat 下图为某个时刻统计的调用结果： 上图中实例x.x.0.55:8009关闭了优雅上线， 实例x.x.0.51:8004开启了优雅上线，观察请求数（requestCount）与QPS，可观察到开启优雅上线的实例的QPS与请求数都小于关闭优雅上线的实例。持续观察流量请求情况，直到两个实例QPS基本持平则结束验证。 验证优雅下线能力。 优雅下线验证部署图如下： 如上图，该套nacos应用有nacos-rest-consumer、nacos-rest-provider（两个实例）、nacos-rest-provider-close-grace（两个实例）以及nacos-rest-data服务，其中服务nacos-rest-provider-close-grace关闭了优雅下线，其他服务开启优雅下线。 服务说明。 nacos-rest-provider-close-grace与nacos-rest-provider同属于一个jar应用，nacos-rest-provider-close-grace请使用环境变量“spring_application_name=nacos-rest-provider-close-grace”进行指定。 关闭优雅下线的方法。 添加环境变量“grace_rule_enableGraceShutdown=false”进行指定。 nacos-rest-consumer通过调用接口graceDownOpen测试验证优雅下线能力；调用接口graceDownClose对比未开启优雅下线时请求处理情况。查看调用情况可使用nacos-rest-consumer接口的stat方法进行请求统计。 下载demo应用并打包。 按照优雅下线验证部署图进行部署，并关闭nacos-rest-provider-close-grace的优雅下线能力。 查看应用是否已全部接入ServiceComb引擎。 参考查看微服务列表查看您的应用是否已接入ServiceComb引擎。 待应用接入ServiceComb引擎后，使用如下脚本invoke.sh模拟请求。 #!/bin/bash endpoint=127.0.0.1:31021 openUrl=${endpoint}/graceDownOpen closeUrl=${endpoint}/graceDownClose while true do echo `curl -s ${openUrl}` echo `curl -s ${closeUrl}` done endpoint为服务nacos-rest-consumer实例的请求地址，即ip:port。需根据实际nacos-rest-consumer地址进行替换。 openUrl为开启优雅下线能力的调用接口。 closeUrl为关闭优雅下线能力的调用接口。 查看应用的请求情况。 参考如下脚本stat.sh查看请求调用情况: #!/bin/bash endpoint=127.0.0.1:31021 watch curl ${endpoint}/stat endpoint为服务nacos-rest-consumer实例的请求地址，即ip:port。 对服务进行缩容，模拟下线。 分别对nacos-rest-provider-close-grace与nacos-rest-provider进行缩容，将实例缩容为1个。 使用4的脚本，查看服务调用情况。 上图中，graceDownClose为关闭优雅下线能力的请求统计，可以看到存在4个错误请求（errorCount）， 而下方graceDownOpen为开启优雅下线能力的请求统计，可以看到未出现错误请求。

版本支持 Spring Cloud Version Spring Boot Version Zookeeper Discovery Version Nacos Discovery Version Consul Discovery Version Eureka Client Version Edgware.SR2+ 1.5.x 1.x.x、2.0.x 1.5.x 1.x.x、2.0.x、2.1.x 1.4.x、2.0.x、2.1.x Finchley.x 2.0.x 2.x.x 1.5.x、2.0.x、2.1.x 1.3.x、2.0.x、2.1.x 1.4.x、2.0.x、2.1.x Greenwich.x 2.1.x 2.x.x 1.5.x、2.0.x、2.1.x 1.3.x、2.0.x、2.1.x 1.4.x、2.0.x、2.1.x Hoxton.x 2.2.x、2.3.x 2.x.x、3.0.0 - 3.1.0 2.x.x、2020.0.RC1、2021.1 1.3.x、2.0.x、2.1.x、2.2.x 1.4.4.RELEASE - 1.4.7.RELEASE、2.x.x、3.0.0 - 3.1.0 2020.0.x 2.4.x、2.5.x 3.0.0 - 3.1.0 2.x.x、2020.0.RC1、2021.1 3.0.0 - 3.1.0 2.1.x、2.2.x、3.0.0 - 3.1.0 2021.0.0 2.6.x 3.0.0 - 3.1.0 2.x.x、2020.0.RC1、2021.1 3.0.0 - 3.1.0 3.0.0 - 3.1.0

优雅下线实现机制 延迟下线是优雅下线的核心机制，且Sermant Agent还提供了流量统计机制，即服务处理完所有统计的请求后再下线，减少流量丢失，从而实现了优雅下线。 图1 优雅下线结构图 延迟下线 当服务提供者实例下线时，无法避免仍有业务请求还未处理完成，从而可能会出现请求丢失的现象。延迟下线即对下线的实例提供保护，优雅下线插件基于下线实时通知+刷新缓存的机制快速更新上游的实例缓存，服务消费者能尽早感知服务提供者实例下线的行为，同时基于流量统计的方式，确保即将下线的实例尽可能的将流量处理完成，最大程度避免流量丢失。 流量统计 当服务即将下线时，为确保当前请求已全部处理完成，Sermant Agent会尝试等待30s（可配置），定时统计和判断当前实例请求是否均处理完成，处理完成后最终下线。

优雅上线实现机制 预热是优雅上线的核心机制，Sermant Agent还提供了延迟注册机制，减少流量丢失，从而实现优雅上线。 延迟注册 在服务启动成功之后不立刻注册，而是延迟一段时间再去注册，目的是虽然服务启动成功了，但可能还有一些框架或者业务的代码没有初始化完成，可能会导致调用报错，可以通过设置延迟注册，让服务充分初始化后再注册到注册中心对外提供服务。 预热 该方式主要用于解决当流量突然增加时，可能瞬间把实例压垮的问题。通过预热，让通过的流量缓慢增加，在一定时间内逐渐增加到阈值上限，目的是采用少流量对服务实例进行初始化，防止服务崩溃。预热是基于客户端实现的，当流量进入时，Sermant Agent会动态调整流量，根据服务的预热配置，对流量进行动态分配。对于开启服务预热的实例，在刚启动时，会给该实例分配较少的流量，随后流量将以曲线方式逐渐增加至与其他实例近乎持平。