更新时间:2024-01-22 GMT+08:00

灰度发布(金丝雀)方式升级

组件创建并部署完成后,根据业务需要,可使用“灰度发布(金丝雀)”方式升级状态为“运行中”“未就绪”的单个组件版本配置。

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

灰度发布(金丝雀)的类型及具体说明请参见表1

表1 灰度发布(金丝雀)类型及具体说明

类型

说明

微服务灰度发布

适用于微服务组件(ServiceComb/Spring Cloud),灰度发布任务作用于微服务,可通过多个微服务协作,共同完成新特性的上线。

  1. 要求组件选择了Java、Tomcat或者Docker技术栈。
  2. 要求组件绑定了未开启安全认证的微服务引擎且未开启多语言接入Mesher服务网格。
  3. ServiceComb要求2.7.8及以后版本;Spring Cloud Huawei要求1.10.4-2021.0.x及以后版本。

ELB灰度发布

适用于通过ELB作为流量入口的任何类型组件;灰度发布任务作用于ELB。

要求组件开放了公网访问并绑定了ELB。

仅部署环境为Kubernetes类型的组件,且组件实例数量在2个及以上时,支持灰度发布(金丝雀)升级。

如需批量升级同一个应用下的多个组件版本配置,请参考批量升级组件版本配置

前提条件

已完成组件创建与部署,请参考创建并部署组件

操作步骤

  1. 登录ServiceStage控制台。
  2. 选择以下任意方式进入组件“概览”页面:

    • “应用管理”页面,单击组件所属应用名称,在“组件列表”单击待操作组件名称。
    • “组件管理”页面,单击待操作组件名称。

  3. 在页面右上角,单击“升级”
  4. “升级类型”选择“灰度发布(金丝雀)”
  5. 单击“下一步”,参考下表设置组件版本配置信息,其中带“*”标志的参数为必填参数。

    参数

    说明

    技术栈

    固定为创建并部署组件时选择的技术栈。

    *软件包/镜像

    固定为创建并部署组件时选择的组件来源。

    选择“源码仓库”,参考仓库授权创建授权,设置代码来源。

    选择软件包,则组件来源支持的软件包类型由您选择的技术栈类型决定,具体情况请参考表1

    *上传方式

    选择软件包或者镜像包,重新选择已上传的软件包/镜像包,上传方式请参考组件来源说明

    *编译命令

    组件来源是源码、部署环境为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.1214.172318,则版本号为2022.1214.17238。
    • 您也可以自定义版本号,格式为:A.B.C或者A.B.C.D。A、B、C、D为自然数,例如:1.0.0或者1.0.0.0。
      须知:
      • 自定义版本号需唯一,请勿与该组件的历史版本号重复。

    资源

    组件部署环境为Kubernetes类型时可设置。

    组件无法调度到剩余资源小于申请值的节点上,配置方法请参考资源限制指南

    可以根据需要自定义“CPU配额”“内存配额”,修改组件运行可以使用的最大/最小CPU核数(Core)和内存数量(GiB)。如需修改,请勾选待修改项后输入新的配置值。

    不勾选,表示不限制。

    JVM参数

    技术栈类型选择Java/Tomcat时可设置,用于配置Java代码运行时的内存参数大小。

    输入JVM参数,如-Xms256m -Xmx1024m,多个参数以空格间隔,不填则为空。

    Tomcat配置

    技术栈类型选择Tomcat时可设置,用于配置Tomcat请求路径、端口号等参数。

    1. 勾选“Tomcat配置”,弹出“Tomcat配置”对话框。
    1. 单击“使用示例模板”,根据业务要求编辑模板文件。
    2. 单击“确定”

    高级设置

    请参考10,设置“组件配置”“部署配置”“运维监控”参数。

    灰度策略

    • 灰度流量比例:引入到新版本的流量比例。
    • 当前流量比例:引入到当前版本的流量比例。

    *首批灰度实例数量

    首批灰度发布的实例数量,取值范围为[1, 当前总实例数-1]。当前总实例数,即组件当前运行的实例数量。

    例如,当前组件总实例数为6,“首批灰度实例数量”参数设置为1,则表示首批升级组件版本配置的实例数量为1。

    剩余实例部署批次

    首批灰度发布成功之后,剩余实例滚动升级分多少批次完成。

    例如,当前组件总实例数为6,“首批灰度实例数量”参数设置为1,且“剩余实例部署批次”设置为3。则当前剩余实例数为5,那么升级剩余实例会按照2:2:1个实例分批升级。

  6. 单击“升级”

    等待组件状态由“升级/回滚中”转换为“运行中”,表示已成功完成组件版本配置升级。

后续操作

操作

说明

查看系统监控

通过灰度发布(金丝雀)升级组件版本配置时,首批灰度发布完成后,选择“系统监控”页签,可以监控灰度版本和当前版本实例的CPU、内存使用情况。

滚动升级剩余实例

通过灰度发布(金丝雀)升级组件版本配置时首批灰度发布成功且验证新版本功能正常后,如需升级剩余组件实例版本到新版本,请执行以下操作:

  1. 选择“灰度发布(金丝雀)”类型的“部署记录”
  2. 单击“滚动升级剩余实例”
  3. 在弹出对话框,单击“确定”

    按照5设置的升级策略升级剩余的实例到新版本。

回滚组件版本配置

下列情况支持回滚组件版本配置:

  • 通过灰度发布(金丝雀)升级组件版本配置时首批灰度发布完成后
  • 组件全部实例的版本配置升级到新版本后

回滚到升级前组件版本配置,请参考回滚组件版本配置

重新部署组件

根据业务需要,您可以在“部署记录”列表中选择历史版本配置,并以此版本配置为模板,重新部署组件,请参考重新部署组件