最佳实践

别名管理相关操作

最近更新时间:2020-06-03 08:33:58

简介

云函数(Serverless Cloud Function,SCF)的别名是指向已绑定函数版本的指针,通过使用别名可以调用已绑定的函数。在实际的开发过程中,别名可以帮助您更好的管理项目版本的更新和回滚。同一个版本的函数可以有一个或多个别名,关于函数版本管理请参见 版本管理概述

使用场景

可以通过别名的设置,为函数创建出多个不同的环境(stage)的区分。例如:

  • 可通过创建 test、release 别名,并配置触发器指向这些别名,来使得不同的代码和配置生效。
  • 可使用别名绑定不同的函数版本,待版本通过测试环境验证后,将正式环境的流量通过路由配置转移到新版本上。流量路由配置的方法请参见 流量路由配置说明

默认别名

函数在创建后缺省具有一个默认别名($DEFAULT),默认别名生成时指向最近版本($LATEST)。默认别名不可删除或修改名称,但支持流量路由配置。

默认别名的使用

在通过云 API 调用函数,或配置触发器来触发函数时,如果未指定函数调用的具体版本或别名,即调用时的 Qualifier 参数为空,那么调用将缺省使用默认别名($DEFAULT)。

说明:

通过配置默认别名,可以将触发器来源或云 API 接口调用产生的默认流量进行路由控制。

别名的触发器

目前云函数已创建的别名均可以独立绑定触发器。触发器的调用将经过别名,并依据别名的路由配置拉起具体的版本执行。

操作步骤

创建别名

  1. 登录云函数控制台,选择左侧导航栏中的【函数服务】。
  2. 在“函数服务”列表页面中,单击函数名,进入该函数详情页面。
  3. 选择页面右上角的【操作】>【创建别名】。如下图所示:
  4. 在弹出的“创建别名”窗口中,参考以下信息进行创建。如下图所示:
    注意:

    别名创建完成后,将无法修改别名的名称。


    主要参数信息如下:
    • 别名名称:自定义名称。最长60个字符,最短2字符,以字母开头,可包含 a - zA - Z0 - 9-_,且需要以数字或字母结尾,例如 Tencent-cloud_scf
    • 别名描述:自定义描述。最长1000个字符,可包含英文字母、数字、空格、逗号、句号、中文。
    • 路由方法及版本权重配置:详情请参见 流量路由配置
  5. 单击【提交】即可完成创建。

修改函数版本绑定的别名

  1. 选择函数详情页右上角的【操作】>【流量设置】。如下图所示:
  2. 在弹出的“流量设置”窗口中,参考以下信息进行设置。如下图所示:

    主要参数信息如下:
    • 别名:在下拉列表中,选择该版本期望绑定的别名。本文以 test02 为例。
    • 路由方法及版本权重配置: 配置方法详情请参见 流量路由配置,本文以修改 $LATEST 版本绑定别名为例:
      • 路由方法选择为【按权重路由】。
      • 版本权重配置为:版本 $LATEST 70%权重路由,版本130%权重路由。
  3. 单击【提交】即可完成修改,打开版本下拉列表,即可查看修改后效果。如下图所示:

删除别名

注意:

仅永久删除该别名,不包括底层版本代码和配置。

  1. 选择在函数详情页右上角的【操作】>【删除别名】。如下图所示:
  2. 在弹出的“删除别名”窗口中,在下拉列表中选择需删除的别名,并单击【提交】即可。本文以删除别名 test02 为例。如下图所示:
目录