本文介绍从开通边缘程序服务到使用边缘程序的全流程,便于您快速上手边缘程序。

流程概览

当您初次使用边缘程序时,需要先开通全站加速DCDN产品。本文以“HelloWorld”为例介绍边缘程序快速入门流程,具体步骤如下图所示:开通边缘程序

开通边缘程序

  1. 登录全站加速控制台
  2. 在左侧导航栏,单击边缘程序
  3. 单击开通边缘程序 > 立即开通开通边缘程序服务。

创建和配置程序

  1. 登录全站加速控制台
  2. 在左侧导航栏,单击边缘程序
  3. 边缘程序页面,单击设置子域,输入子域名称。
    说明
    • 子域相当于一个仓库,您创建的边缘程序均放在该仓库下,子域设置后无法修改。
    • 子域是每个用户的唯一标识符,子域也将用作程序ID的一部分。
    • 子域名称仅支持小写英文字母、数字、中划线。
  4. 边缘程序页面,单击创建程序
    创建程序
    参数 说明
    程序名称 请输入程序名称。
    说明 支持小写英文、数字和中划线,名称长度不能小于2个字符,例如routine-name。程序名创建后无法修改。
    描述 (选填)程序的描述信息。
    规格 程序代码单次执行最多使用的CPU时间(不包含等待网络请求响应的I/O时间),不同规格的费用不同,默认选择50ms规格。更多计费信息,请参见计费说明
    • 5ms:单个请求可用CPU时间片:5ms。RT最大值120秒,可用内存128MB。
    • 50ms(默认):单个请求可用CPU时间片:50ms。RT最大值120秒,可用内存128MB。
    • 100ms:单个请求可用CPU时间片:100ms。RT最大值120秒,可用内存128MB。
  5. 程序创建完成后,可单击详情进入程序详情页进行配置,各个环境的配置相互独立,您可以按需分别修改生产环境、测试环境和灰度环境(选配)的配置。详情
    参数 说明
    程序规格 程序代码单次执行最多使用的CPU时间(不包含等待网络请求响应的I/O时间),默认选择50ms规格。
    • 5ms:单个请求可用CPU时间片:5ms。RT最大值120秒,可用内存128MB。
    • 50ms(默认):单个请求可用CPU时间片:50ms。RT最大值120秒,可用内存128MB。
    • 100ms:单个请求可用CPU时间片:100ms。RT最大值120秒,可用内存128MB。
    域名白名单
    • 允许关联该程序的域名。
    • 支持填写泛域名。
    • 域名白名单默认为空,表示任意域名都可关联该程序。
    说明 例如您设置了example.com,则表示只有example.com的请求可以触发该程序执行,其他域名的请求将被该程序拒绝。

域名关联程序

程序创建并配置完毕后,您需要将CDN/DCDN的域名关联该边缘程序,客户端通过访问域名触发程序执行。

  1. 登录阿里云CDN平台/全站加速控制台
    说明 程序需要域名作为入口供客户端访问,域名可使用CDN加速域名或全站加速域名,具体以您域名所在的产品进入对应控制台为准。
  2. 在左侧导航栏,单击域名管理
  3. 域名管理页面,单击目标域名对应的管理/配置
  4. 在指定域名的左侧导航栏,单击边缘程序
  5. 边缘程序页面,开启并配置边缘程序ID。
    边缘程序
    参数 说明
    边缘程序ID 边缘程序ID是每个程序的唯一标识符。组成方式:程序名称.子域。
    说明 在全站加速控制台左侧,单击边缘程序管理,选择您需要查看的程序名称,单击详情,在配置页面的基本信息区域获取边缘程序ID。
    触发模式 访问CDN/DCDN域名的请求将触发边缘程序执行,执行方式有两种:
    • 重定向:CDN/DCDN域名的请求将被边缘程序完全接管。边缘程序内的代码逻辑由您自行开发,可直接返回结果给客户端、通过CacheAPI读取缓存、通过fetch请求回源等。
    • 旁路:CDN/DCDN域名的请求仅触发边缘程序执行,随后继续执行CDN/DCDN配置并回源,适合于一些鉴权校验或日志打点的场景。
    执行异常时是否回源
    • :当边缘程序执行异常,边缘节点将以客户端URL的形式请求CDN/DCDN域名源站,您可以在源站实现兜底和容灾机制。
    • :当边缘程序执行异常,直接返回5xx状态码给客户端。
      说明 首次使用边缘程序建议您该参数设置为否,通过返回5xx状态码可排查使用中遇到的问题。

开发并调试程序

  1. 登录全站加速控制台
  2. 在左侧导航栏,单击边缘程序
  3. 选择您创建的程序,单击详情
  4. 详情页面,单击代码,即可开始使用JavaScript开发边缘程序(默认是HelloWorld示例代码)。代码
  5. 编写完代码后,单击保存并发布到测试环境测试您可以选择页面上提供的任一测试环境IP进行Host绑定测试,调试程序代码。image02
    说明 绑定Host的方式是修改测试机本地Host文件,加入测试IP和域名。例如添加10.10.10.10 example.com(IP替换为上图提供的任一IP,域名替换为您关联该程序的CDN/DCDN域名)。

生成正式版本

代码调试完毕后,在代码页面,单击生成正式版本测试

发布

详情页面,单击版本和发布,选择一个版本ID单击发布即可选择需要发布的环境,选择生产环境并确定,所有生产环境的节点都将部署该版本的程序代码。

日常迭代

以上是HelloWorld示例程序的配置和发布。
  • 日常的程序代码更新迭代您可以参考:开发并调试程序、生成正式版本、发布三个环节。
  • 如果您需要调整程序规格、域名白名单等程序的配置,可参考:创建和配置程序。
  • 如果您希望关闭CDN/全站加速域名的边缘程序功能,删除域名关联程序中的边缘程序配置即可。
步骤