文档

控制台配置边缘脚本

在视频直播控制台上,您可以根据边缘脚本(EdgeScript)定义的代码规则,创建边缘脚本规则并发布到生产环境,从而实现对视频直播产品的定制化管理。本文介绍在控制台使用边缘脚本的步骤。

前提条件

您已开通边缘脚本服务,开通服务请提交工单。关于如何提交工单,请参见联系我们

背景信息

边缘脚本使用分为两种情况:
  1. 初次配置边缘脚本。1
  2. 更新已有的边缘脚本配置。2

初次配置边缘脚本

  1. 登录视频直播控制台

  2. 在左侧导航栏单击域名管理,进入域名管理页面。

  3. 选择您要配置的播流域名,单击域名配置

  4. 单击直播管理 > 边缘脚本,进入模拟环境页签。

  5. 单击添加规则,配置边缘脚本规则。

    说明

    目前单个域名仅支持添加一条边缘脚本规则。如果您需要添加多条规则,请提交工单申请。

    添加边缘脚本规则

    配置信息及说明,请参见下表:

    配置信息

    是否必填

    说明

    规则名称

    规则名。仅支持英文字母、数字和下划线。

    规则代码

    输入规则代码。

    优先级

    规则优先级。取值范围0~99,0表示优先级最高,99表示优先级最低。

    执行位置

    规则执行位置。

    启用状态

    规则启用状态。

    Break

    本规则命中情况下,是否终止本阶段剩余规则的执行。

    开启后,匹配该规则,停止执行其余的边缘脚本规则。

    扩展项

    当前支持扩展。目前仅支持_es_dbg=signature字段,用于增加调试响应头。

    添加完后,您可以单击打开调试工具进行单请求测试(可选)。

    1. 配置请求方法、协议、HOST、URL、请求头、请求体。

      说明
      • HOST通过Pingstaging.myalicdn.com获取模拟环境的测试节点IP,填写到HOST地址输入框。

      • URL示例:http://example.com/image/***.jpg

      • 请求头示例:Accept-Encoding: gzip, deflate, br

    2. 单击提交测试发起请求。

    3. 收到响应结果。

  6. 单击发布到模拟环境,在模拟环境中测试规则。

    模拟环境测试IP地址以实际页面显示为准,请参见下图:测试IP

    在客户端路径C:\Windows\System32\drivers\etc中找到hosts文件。将模拟环境测试IP地址添加到hosts文件中。

    重要
    • 终端为Windows系统,路径为C:\Windows\System32\drivers\etc\hosts

    • 终端为macOS系统,路径为/etc/hosts

  7. 测试完成后,单击发布所有规则到生产环境,将模拟环境规则发布至生产环境。

    重要

    模拟环境规则发布到生产环境后,模拟环境的规则自动被清空。

更新边缘脚本配置

  1. 单击回滚模拟环境下的配置,即把模拟环境的配置还原到初始状态。

  2. 单击从生产环境复制规则,将发布到生产环境的规则同步到模拟环境。

  3. 在模拟环境页面下,单击操作列下的修改,更新边缘脚本规则。

  4. 更新完成后,单击打开调试工具进行单请求测试。

  5. 单击发布到模拟环境,在模拟环境中测试规则。

  6. 测试完成后,单击发布所有规则到生产环境,将模拟环境规则发布至生产环境。

    重要

    模拟环境规则发布到生产环境后,模拟环境的规则自动被清空。