在视频直播控制台上,您可以根据边缘脚本(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. 测试完成后,单击发布所有规则到生产环境,将模拟环境规则发布至生产环境。
    注意 模拟环境规则发布到生产环境后,模拟环境的规则自动被清空。