应用管理与运维平台 SERVICESTAGE-灰度发布方式升级组件版本配置:灰度发布方式升级组件版本配置

时间:2024-10-21 09:52:34

灰度发布方式升级组件版本配置

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

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

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

    参数

    说明

    技术栈

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

    *软件包/镜像

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

    • 选择“源码仓库”,参考仓库授权创建授权,设置代码来源。
    • 选择软件包或者镜像包,则固定为创建并部署组件时选择的软件包类型(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个字符的字符串,可以包含小写英文字母、数字和中划线(-),并以小写英文字母开头,小写英文字母或数字结尾。

    资源

    您可以根据需要自定义“CPU配额”“内存配额”,设置组件运行可以使用的最大/最小CPU核数(Core)和内存数量(GiB),从而选择性地为每个组件的实例设定所需要的资源数量。

    当您为组件实例指定了资源“申请”时,CCE就利用该信息决定将组件实例调度到哪个节点上;当您为组件实例指定了资源“限制”时,CCE就可以确保运行的组件实例占用的资源不会超出所设限制。CCE还会为组件实例预留所申请数量的系统资源。申请值和限制值的配置说明及建议,请参考资源限制指南

    如需修改,请勾选待修改项后输入新的配置值。不勾选表示不限制。

    JVM参数

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

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

    Tomcat配置

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

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

      Tomcat配置,使用默认server.xml配置,上下文路径是"/",没有指定应用路径。

      如需自定义应用路径,请参考定制Tomcat Context path

    3. 单击“确定”

    容器配置

    请参考管理容器部署组件容器配置,根据您的实际业务需要进行设置。

    高级配置

    请参考管理容器部署组件高级配置,根据您的实际业务需要进行设置。

    *部署架构

    1. 单击“选择”,根据业务实际情况正确选择灰度升级时实例部署架构。
    2. 单击“确定”
    须知:

    所选部署架构必须准确匹配,否则会导致灰度失败,业务受损。

    单击“更改”,可重新选择部署架构。

    *灰度策略

    根据业务实际情况选择灰度升级策略。

    • 基于流量比例:根据需要灵活动态的调整不同服务版本的流量比例。
    • 基于内容:根据请求的内容控制其流向的服务版本。
      说明:

      ELB灰度发布,仅支持“基于流量比例”

    *选择流量比例

    “灰度策略”选择“基于流量比例”时,根据业务实际情况设置版本流量比例。

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

    *生效方式

    “灰度策略”选择“基于内容”时,根据业务实际情况设置灰度策略生效方式。

    • 满足任意条件:满足任意一条“匹配规则”时,灰度策略生效。
    • 满足所有条件:满足所有“匹配规则”时,灰度策略生效。
      说明:

      ELB灰度发布,仅支持“满足所有条件”

    *匹配规则

    “灰度策略”选择“基于内容”时,根据业务实际情况设置灰度策略生效的匹配规则。

    1. 单击“添加匹配条件”
    2. 设置“匹配类型”,当前仅支持基于“请求头”类型的匹配。
    3. 设置“参数名称”,即“匹配类型”对应的key值。
    4. 设置“条件类型”,即“条件值”满足的匹配规则。
      • 相等:“匹配类型”对应的value值和设置的“条件值”相等。
      • 匹配:“条件值”支持PERL兼容的正则表达式,仅微服务灰度发布支持。
      • 枚举:多个“条件值”以逗号(,)间隔。
    5. 设置“条件值”,即“匹配类型”对应的value值。

    *灰度实例新增模式

    根据业务实际情况选择灰度升级时新增实例的模式。

    • 蓝绿

      先增加与老版本实例同等数量的新版本实例,按照灰度规则将流量引入新版本实例。根据灰度规则验证完成后将所有流量引入新版本,再删除老版本实例。

      适用于业务容量无损、回滚快、集群中需要有剩余资源的场景。

      蓝绿模式需要组件实例数量在1个或以上。

    • 金丝雀(先增后减)

      新增指定数量的新版本实例,按照灰度规则将流量引入新版本实例。根据灰度规则验证完成后循环执行“删除固定数量的老版本实例,新增固定数量的新版本实例,同时配合流量调整”,直到所有的流量引入新版本实例,所有的老版本实例被删除。

      适用于业务容量无损、回滚慢、集群中需要有剩余资源的场景。

      金丝雀(先增后减)模式需要组件实例数量在2个或以上。

    • 金丝雀(先减后增)

      删除指定数量的老版本实例,新增指定数量的新版本实例,按照灰度规则将流量引入新版本实例。根据灰度规则验证完成后循环执行“删除固定数量的老版本实例,新增固定数量的新版本实例,同时配合流量调整”,直到所有的流量引入新版本实例,所有的老版本实例被删除。

      适用于业务容量有损、回滚慢的场景。

      金丝雀(先减后增)模式需要组件实例数量在2个或以上。

    说明:

    如需修改组件实例数量以满足灰度升级时新增实例的模式要求,请参考设置手动伸缩策略

    *缩容时间窗

    您可以设置一个缩容时间窗,用于在组件实例停止前保存重要数据。取值范围为0-9999秒,默认设置为30秒。

    例如某应用有两个实例,执行缩容操作,缩容后只剩一个实例,则您仍然可以在设置的时间窗内对即将要停止的实例进行某些操作。

  6. 单击“升级”

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

support.huaweicloud.com/usermanual-servicestage/servicestage_03_0122.html