概述
灰度发布(又名金丝雀发布)是指在黑与白之间,能够平滑过渡的一种发布方式。
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:
parameters:
qualifier: alias-prod
cronExpression: '*/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}}'
本页内容是否解决了您的问题?