IBM Cloud Docs
使用边缘功能操作和触发器

使用边缘功能操作和触发器

边缘功能由两个主要部分组成:动作和触发器。 操作是 JavaScript 文件,用于定义在边缘运行的逻辑。 触发器是基于 URL 的路由规则,可定义何时以及在何种情况下运行这些操作。 触发器将特定的请求模式(如域和路径)与相应的操作连接起来。 如果没有相关的触发器,操作就不会影响流量。

边缘功能操作

操作使用 JavaScript 编写,并且需要事件侦听器以响应触发器事件。 除非使用触发器,否则操作不会影响流量。

计划差异

行动时的差异取决于您的计划:

标准计划

  • 每个账户只允许一个操作,并自动以您的域名命名(名称不可更改)。
  • 要更新操作,请上传新的 JavaScript 文件或直接在编辑器中编辑代码。 上传新文件会取代现有操作。
  • 当您上传 JavaScript 文件时,其名称总是设置为您的域名。

企业计划

  • 可上传数量不限的脚本,每个脚本都有唯一的名称(如果需要)。
  • 创建操作时,可以指定自定义名称。
  • 上传 JavaScript 文件时,操作名称取自文件名。

使用操作

您可以创建、上传、编辑和管理操作,以定义 Edge 功能根据触发事件运行的逻辑。 控制台为每个核心操作提供工具:

  • 创建操作- 单击创建,使用内置代码编辑器添加操作。 添加 JavaScript 代码后,单击“**保存 **”创建操作。

  • 阅读操作- 点击操作表中的现有操作,在编辑器中打开该操作。 这样,您就可以查看其代码,而无需进行更改。

  • 更新操作- 要修改操作,请单击列表中的操作,在编辑器中打开该操作。 进行更改,然后单击保存。 保存更改后,更新的操作将被上传。 如果正在使用该操作,更新会立即生效。

  • 上传操作- 单击“上传”上传 JavaScript 文件。 上传或创建与现有操作名称相同的操作会导致现有操作被覆盖。 上传前重命名操作文件,或在创建时输入唯一名称,以避免出现这种行为。

    上传也可以作为创建或更新操作的一部分,这取决于名称是否已经存在。

  • 删除操作- 要删除操作,请单击所选操作表格行中的删除图标删除图标。 与触发器关联的操作不能删除。 要删除操作,必须先删除使用该操作的所有触发器。 用途 "栏显示每个操作有多少个触发器。

  • 关联触发器- 触发器是运行操作的必要条件。 从“触发器”选项卡中添加触发器,并从现有操作列表中选择操作。 操作表中的“使用”列显示当前与每个操作关联的触发器数量。

边缘功能触发器

触发器(路由)决定域流量如何路由到操作。 它们将基于账户域的 URL 模式与预定义的操作联系起来。 URL 模式必须包括域,并可包含通配符,作为域的前缀或在路径末尾。 如果没有指定路径,则会隐式添加 /。 URL 模式不能包含下位通配符或查询参数。

计划差异

不同计划的触发器工作方式没有差异。 所有计划都支持添加、编辑和删除触发器。

使用触发器

在添加触发器之前,必须先添加域。 触发器定义了如何将流量路由到边缘功能操作。 触发器将 URL 模式与现有操作连接起来。

即使还没有任何操作,也可以创建触发器,但在选择操作之前,触发器不会调用任何逻辑。

  • 添加触发器- 转到“触发器”选项卡并单击“添加触发器”。 输入 URL 模式,然后从现有操作列表中选择与该模式相关联的操作。 这就在路线和行动之间建立了联系。

    要在不运行边缘功能的情况下保持触发路径处于活动状态,请启用避免边缘功能。 例如,如果 my-function 已分配给 gamma.cistest-load.com/*,但希望 gamma.cistest-load.com/data 绕过它,则应为 /data 创建一个单独的触发器,并启用避免边缘功能。 这样可确保 /data 路径保持活动状态,而无需调用 my-function

  • 编辑触发器- 单击要修改的触发器表行中的 编辑 图标 编辑图标,然后进行修改并单击 节省

  • 删除触发器- 单击要修改的触发器表行中的 删除 图标 删除图标。 此操作无法撤销。 删除触发器会删除路由与操作之间的关联。