tencent cloud

文档反馈

灰度发布

最后更新时间:2024-11-28 17:00:58

    概述

    灰度发布(又名金丝雀发布)是指在黑与白之间,能够平滑过渡的一种发布方式。
    Serverless 应用的灰度发布是配置云函数别名的流量规则,针对别名中两个不同版本的云函数进行流量规则配置。Serverless Framework 支持的两种方式别名配置:默认别名自定义别名

    默认别名

    默认别名是配置云函数的 $default(默认流量)别名。该别名中固定有两个云函数版本,一个为 $latest 版本,一个为最后一次函数发布的版本。部署时配置的 traffic 参数为 $latest 版本流量占比,默认另一部分流量切到当前云函数最后一次发布的版本。
    每次上线一个新功能,执行sls deploy会部署到 $latest 版本上。我们将切部分流量在 $latest 版本上进行观察,然后逐步将流量切到 $latest 版本。当流量切到100%时,我们会固化这个版本,并将流量全部切到固化后的版本。
    
    
    

    命令说明

    说明:
    旧版本命令为sls deploy --inputs.key=value,Serverless CLI V3.2.3 后命令统一格式为 sls deploy --inputs key=value ,旧版本命令在新版本 Serverless CLI 中不可用,升级 Serverless CLI 的用户请使用新版本命令。

    函数发布版本

    部署时发布项目下所有函数版本:
    sls deploy --inputs publish=true

    函数流量设置

    部署后切换20%流量到 $latest 版本:
    sls deploy --inputs traffic=0.2
    Serverless Framework 流量切换修改的是云函数别名为 $default 的流量规则。
    每次配置针对的是 $latest,最后一次云函数发布的版本的配置。
    traffic 配置的值为 $latest 版本对应的流量占比,最后一次云函数发布的版本的流量占比为 1-$latest 流量占比。(如 traffic=0.2,实则配置 $default 的流量规则为 {$latest:0.2, 最后一次云函数发布的版本: 0.8})
    如果函数还未发任何固定版本,只存在$latest版本的函数情况下,traffic 无论如何设置,都会是 $latest:1.0。

    操作步骤

    当一个功能测试完毕,需要进行灰度发布,操作如下:
    1. 配置生产环境信息到 .env 文件(STAGE=prod 为生产环境):
    TENCENT_SECRET_ID=xxxxxxxxxx
    TENCENT_SECRET_KEY=xxxxxxxx
    STAGE=prod
    2. 部署到线上环境 $latest,并切换10%的流量在 $latest 版本(90%的流量在最后一次发布的云函数版本 N 上):
    sls deploy --inputs traffic=0.1
    3. 对 $latest 版本进行监控与观察,等版本稳定之后把流量100%切到该版本上:
    sls deploy --inputs traffic=1.0
    4. 流量全部切换成功后,对于一个稳定版本,我们需要对它进行标记,以免后续发布新功能时,如果遇到线上问题,方便快速回退版本。部署并发布函数版本 N+1,切换100%流量到版本 N+1:
    sls deploy --inputs publish=true traffic=0

    自定义别名

    自定义别名可以通过命令创建别名,配置指定两个云函数版本配置流量比。
    使用自定义别名进行灰度发布时,先将新功能发布到一个新版本上,然后修改别名配置,切部分流量在该版本上进行观察,最后逐步将流量切到该版本。
    自定义别名提供了灵活的版本切换,配置相对于默认别名的方式更复杂,适用于对灰度发布能力要求比较高的业务场景。目前自定义别名只支持云函数组件。
    
    
    

    命令说明

    函数发布版本

    不部署直接给函数 my-function 发版本:
    sls publish-ver --inputs function=my-function

    创建别名

    给云函数 my-function 创建别名 routing-alias,路由规则为版本1流量为50%,版本2流量为50%:
    sls create-alias --inputs name=routing-alias function=my-function version=1
    config='{"weights":{"2":0.5}}'

    更新别名

    更新云函数 my-function 别名 routing-alias 的流量规则为版本1流量为10%,版本2流量为90%:
    sls update-alias --inputs name=routing-alias function=my-function version=1 config='{"weights":{"2":0.9}}'

    列举别名

    列举云函数 my-function 别名 routing-alias:
    sls list-alias --inputs function=my-function

    删除别名

    删除云函数 my-function 的别名 routing-alias:
    sls delete-alias --inputs name=routing-alias function=my-function

    操作步骤

    当一个功能测试完毕,需要进行灰度发布,操作如下:
    1. 配置生产环境信息到 .env 文件(STAGE=prod 为生产环境):
    TENCENT_SECRET_ID=xxxxxxxxxx
    TENCENT_SECRET_KEY=xxxxxxxx
    STAGE=prod
    2. 创建别名 alias-prod,配置 alias-prod 的流量规则(假设目前线上稳定版本为 N):
    sls create-alias --inputs function=my-function name=alias-prod version=n config='{"weights":{"$LATEST":0}}'
    3. 配置 my-function 函数的 serverless.yml 中触发器对应的别名引用:
    events: # 触发器
    - timer: # 定时触发器
    name: #触发器名称,默认timer-${name}-${stage}
    parameters:
    qualifier: alias-prod #配置别名为alias-prod
    cronExpression: '*/5 * * * *' # 每5秒触发一次
    enable: true
    argument: argument # 额外的参数
    4. 部署到线上环境 $latest,并发布该新版本(假设函数名为 my-function,发布后的新版本为 N+1):
    sls deploy
    sls publish-ver --inputs function=my-function
    5. 配置云函数别名流量规则,切换10%的流量到 N+1版本(假设原线上版本为 N,云函数中的别名为 alias-prod):
    sls update-alias --inputs function=my-function name=alais-prod version=n config='{"weights":{"n+1":0.1}}'
    6. 持续观察监控,稳定后切换100%到版本 N+1 上:
    sls update-alias --inputs function=my-function name=alais-prod version=n config='{"weights":{"n+1":1}}'
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持