灰度发布方式重新部署组件

灰度发布简介

“灰度发布”方式先选择一定比例的实例升级到新版本，将流量引入到新版本，验证新版本功能是否正常，然后通过滚动升级剩余的实例到新版本。可以保证整体系统的稳定，在初始灰度的时候就可以发现、调整问题，以减少其影响度。

前提条件

• 待操作组件已升级过版本配置，请参考升级单个组件版本配置或批量升级组件版本配置。
• 待操作组件为容器部署方式部署的无状态组件。如果组件技术栈是Docker，需要未开启多容器部署。
• 已回滚组件版本配置的组件版本配置，不能作为模板重新部署组件。

灰度发布方式重新部署组件

1. 登录ServiceStage控制台。
2. 选择以下任意方式进入组件“部署记录”页面：
   • 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称，在左侧导航栏单击“部署记录”。
   • 在“组件管理”页面，单击待操作组件名称，在左侧导航栏单击“部署记录”。

3. 在“部署记录”列表，选择待作为配置模板的历史版本部署记录。
4. 单击在页面右上方“使用此版本重新部署”，弹出“重新部署”对话框。
5. “部署类型”选择“灰度发布”，单击“确定”。
6. 参考下表设置组件版本配置信息，其中带“*”标志的参数为必填参数。

   参数	说明
   技术栈	固定为选择的历史版本配置，不可修改。
   *软件包/镜像	固定为创建并部署组件时选择的组件来源。 选择“源码仓库”，参考创建仓库授权创建授权，设置代码来源。 选择软件包或者镜像包，则固定为创建并部署组件时选择的软件包类型（Jar、War、Zip）或者镜像包类型。由您选择的技术栈类型决定，具体情况请参考表1。
   *上传方式	选择软件包或者镜像包，重新选择已上传的软件包/镜像包，上传方式请参考组件来源说明。 说明： 如果选择的是镜像包： 可重新自定义容器名称：长度为1到63个字符，可以包含小写英文字母、数字或中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。 单击已选择的镜像包卡片右上角的，可修改镜像包来源。
   *编译命令	组件来源是“源码仓库”、部署环境为Kubernetes类型且所选择的技术栈类型为Java、Tomcat、Node.js、Python、Php时支持设置“编译命令”。 使用默认命令或脚本：优先执行代码根目录下的build.sh，不存在则按照所选语言的通用方法编译，如Java语言的mvn clean package。 使用自定义命令：根据所选语言自定义编译命令，或修改build.sh文件后选择使用默认命令或脚本。 须知： 选择“使用自定义命令”时，请在echo、cat、debug命令中慎用敏感信息或者进行敏感信息加密，以免造成敏感信息泄露。 在项目子目录下执行编译命令，需先进入项目子目录，再执行其余脚本命令。例如： cd ./weather/ mvn clean package
   *Dockerfile地址	组件来源是“源码仓库”、部署环境为Kubernetes类型且所选择的技术栈类型为Java、Tomcat、Node.js、Python、Php时支持设置“Dockerfile地址”。 “Dockerfile地址”即Dockerfile文件相对于项目的根目录（./）所在的目录，Dockerfile文件用于镜像构建。 如果未指定“Dockerfile地址”，默认查找项目根目录下的Dockerfile；如果项目根目录下也没有Dockerfile文件，则根据选定的运行环境自动生成Dockerfile。
   *组件版本	组件版本号，支持自动生成和自定义版本号。 自动生成版本号：单击“自动生成”，默认以您单击“自动生成”时的时间来生成版本号，格式为yyyy.mmdd.hhmms，s取时间戳中秒数的个位值。例如：时间戳为2022.0803.104321，则版本号为2022.0803.10431。 自定义版本号：输入格式为A.B.C或者A.B.C.D，A、B、C、D为自然数。例如，1.0.0或者1.0.0.0。 须知： 自定义版本号需唯一，请勿与该组件的历史版本号重复，否则会导致本次部署记录覆盖掉相同版本的历史部署记录。
   *容器名称	组件部署方式为容器部署且技术栈不是Docker时，您可以自定义容器名称。 长度为1到63个字符，可以包含小写英文字母、数字或中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。
   资源	固定为选择的历史版本配置，不可修改。
   JVM参数	固定为选择的历史版本配置，不可修改。 组件技术栈类型为Java/Tomcat时，可用于配置Java代码运行时的内存参数大小。
   Tomcat配置	固定为选择的历史版本配置，不可修改。 组件技术栈类型为Tomcat时，可用于配置Tomcat请求路径、端口号等参数。
   容器配置	固定为选择的历史版本配置，不可修改。
   高级配置	固定为选择的历史版本配置，不可修改。
   *部署架构	单击“选择”，根据业务实际情况选择灰度升级时实例部署架构。 单击“确定”。 须知： 架构选择必须匹配准确，否则会导致灰度失败，业务受损。
   *灰度策略	根据业务实际情况选择灰度升级策略。 基于流量比例：根据需要灵活动态的调整不同服务版本的流量比例。 基于内容：根据请求的内容控制其流向的服务版本。 说明： ELB灰度发布，仅支持“基于流量比例”。
   *选择流量比例	“灰度策略”选择“基于流量比例”时，根据业务实际情况设置版本流量比例。 灰度流量比例：引入到新版本的流量比例。 当前流量比例：引入到当前版本的流量比例。
   *生效方式	“灰度策略”选择“基于内容”时，根据业务实际情况设置灰度策略生效方式。 满足任意条件：满足任意一条“匹配规则”时，灰度策略生效。 满足所有条件：满足所有“匹配规则”时，灰度策略生效。 说明： ELB灰度发布，仅支持“满足所有条件”。
   *匹配规则	“灰度策略”选择“基于内容”时，根据业务实际情况设置灰度策略生效的匹配规则。 单击“添加匹配条件”。 设置“匹配类型”，当前仅支持基于“请求头”类型的匹配。 设置“参数名称”，即“匹配类型”对应的key值。 设置“条件类型”，即“条件值”满足的匹配规则。 相等：“匹配类型”对应的value值和设置的“条件值”相等。 匹配：“条件值”支持PERL兼容的正则表达式，仅微服务灰度发布支持。 枚举：多个“条件值”以逗号（,）间隔。 设置“条件值”，即“匹配类型”对应的value值。
   *灰度实例新增模式	根据业务实际情况选择灰度升级时新增实例的模式。 蓝绿 先增加与老版本实例同等数量的新版本实例，按照灰度规则将流量引入新版本实例。根据灰度规则验证完成后将所有流量引入新版本，再删除老版本实例。 适用于业务容量无损、回滚快、集群中需要有剩余资源的场景。 蓝绿模式需要组件实例数量在1个或以上。 金丝雀（先增后减） 新增指定数量的新版本实例，按照灰度规则将流量引入新版本实例。根据灰度规则验证完成后循环执行“删除固定数量的老版本实例，新增固定数量的新版本实例，同时配合流量调整”，直到所有的流量引入新版本实例，所有的老版本实例被删除。 适用于业务容量无损、回滚慢、集群中需要有剩余资源的场景。 金丝雀（先增后减）模式需要组件实例数量在2个或以上。 金丝雀（先减后增） 删除指定数量的老版本实例，新增指定数量的新版本实例，按照灰度规则将流量引入新版本实例。根据灰度规则验证完成后循环执行“删除固定数量的老版本实例，新增固定数量的新版本实例，同时配合流量调整”，直到所有的流量引入新版本实例，所有的老版本实例被删除。 适用于业务容量有损、回滚慢的场景。 金丝雀（先减后增）模式需要组件实例数量在2个或以上。 说明： 如需修改组件实例数量以满足灰度升级时新增实例的模式要求，请参考设置手动伸缩策略。
   *首批灰度实例数量	“灰度实例新增模式”选择“金丝雀（先增后减）”、“金丝雀（先减后增）”时，需要设置首批灰度发布的实例数量。 取值范围为[1, 当前总实例数-1]。当前总实例数，即组件当前运行的实例数量。 例如，当前组件总实例数为6，“首批灰度实例数量”参数设置为1，则表示首批升级组件版本配置的实例数量为1。
   *剩余实例部署批次	“灰度实例新增模式”选择“金丝雀（先增后减）”、“金丝雀（先减后增）”时，需要设置剩余实例部署批次。即首批灰度发布成功之后，剩余实例滚动升级分多少批次完成。 例如，当前组件总实例数为6，“首批灰度实例数量”参数设置为1，且“剩余实例部署批次”设置为3。则当前剩余实例数为5，那么升级剩余实例会按照2:2:1个实例分批升级。
   *缩容时间窗	您可以设置一个缩容时间窗，用于在组件实例停止前保存重要数据。取值范围为0-9999秒，默认设置为30秒。 例如某应用有两个实例，执行缩容操作，缩容后只剩一个实例，则您仍然可以在设置的时间窗内对即将要停止的实例进行某些操作。

7. 单击“升级”。

   在“部署日志”区域，可查看部署进展，等待部署完成。