文档首页/ 应用管理与运维平台 ServiceStage/ 用户指南（吉隆坡区域）/ 组件管理/ 升级单个组件版本配置/ 灰度发布（金丝雀）方式升级
更新时间：2024-01-22 GMT+08:00
查看PDF
分享

灰度发布（金丝雀）方式升级

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

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

灰度发布（金丝雀）的类型及具体说明请参见表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设置的升级策略升级剩余的实例到新版本。

回滚组件版本配置

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

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

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

重新部署组件

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