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

流程概览

当您初次使用边缘程序时，需要先开通阿里云CDN产品。本文以“HelloWorld”为例介绍边缘程序快速入门流程，具体步骤如下图所示：开通边缘程序
说明 边缘程序目前是Beta功能，仅面向部分客户开放。如果您的CDN日常带宽峰值大于500 Mbps，可以填写信息申请。申请通过后，边缘程序菜单入口才可见。

开通边缘程序

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

创建和配置程序

  1. 登录CDN控制台。
  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. 登录CDN控制台。
  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/全站加速域名的边缘程序功能，删除域名关联程序中的边缘程序配置即可。
步骤