CDN加速

文档中心 CDN Pro 内容刷新

内容刷新

更新时间:2022-08-18 10:26:56

内容刷新

CDN Pro 内容管理提供了缓存刷新功能,供您快速更新CDN Pro上的缓存文件。当您的 Web 服务器(源站)上的资源内容有更新,并且您希望 CDN Pro 也可以立即使用新文件内容响应用户的时候,就可以使用该功能来刷新CDN Pro的缓存文件。典型的内容刷新场景如下:

  • 业务迭代发版时,更新了资源内容,但是源站内容缓存过期时间设置为1周,您希望在源站版本升级后也同步更新CDN Pro上的资源。
  • 网站新闻发布时,Web服务期更新了资源,您希望立即将最新发布的消息推送给您的用户。
  • 业务内容违规,需要清理缓存资源以确保响应给用户的内容是合法的。
  • 您可以在内容管理下执行缓存刷新操作。本文将为您介绍如何在CDN Pro控制台上进行内容刷新。

您可以在内容管理下执行缓存刷新操作。本文将为您介绍如何在CDN Pro控制台上进行内容刷新。

管理内容刷新任务

点击控制台左侧【内容管理】【刷新】菜单,进入内容刷新页面,页面关键元素和说明如下图示及表格:

如何打造云课堂智慧教学平台

序号
关键元素
说明
1 刷新任务列表 您在CDN Pro上创建的历史内容刷新任务列表。列表展示了刷新任务的任务ID、域名、目标环境、操作、文件、目录、提交时间、完成时间、成功率等字段信息。其中:
●任务ID:点击所选任务的ID字段可查看刷新任务详情。
●域名:刷新文件的域名。
●目标环境:刷新任务下发的环境,为生产环境或者演练环境。
●操作:刷新任务的刷新方式,为删除任务或者强制过期任务。
●文件:刷新的文件个数。
●目录:刷新的目录个数。
●正则表达式:正则表达式:刷新的正则表达式个数。
●提交时间:刷新任务的提交时间。支持点击表格头进行升降序排列。
●完成时间:刷新任务在CDN Pro目标环境节点上执行完成的时间。支持点击表格头进行升降序排列。
●成功率:刷新任务在CDN Pro目标环境节点上执行的成功率。假设下发节点M个,N个节点刷新成功,M-N个节点刷新失败,则成功率为N/M*100。当刷新成功率不为100%时,请重新执行刷新任务,以确保节点100%刷新成功。
2 搜索刷新任务 支持采用以下查询条件过滤搜索刷新任务:
●提交时间:选择刷新任务的提交时间区间。
●任务ID/域名:支持通过输入任务ID和域名进行搜索。其中,任务ID仅支持精确查找;刷新域名支持模糊查找。
3 创建刷新任务 创建刷新任务的按钮,用于提交新的刷新任务。
4 查看刷新任务 点击所选任务的ID字段可查看刷新任务详情

创建刷新任务

  1. 进入创建任务表单页。在内容刷新页面下,点击刷新任务列表左上方的“新建刷新任务”按钮,进入创建刷新任务表单页。

  2. 填写任务信息。您需填写的表单信息及字段说明如下图及表格所示:

如何打造云课堂智慧教学平台

字段
说明
目标环境 选择需要执行文件刷新的目标环境,为生产环境或者演练环境。系统默认选择演练环境。
刷新方式 选择文件内容刷新方式,是直接删除内容还是使其过期无效。
删除:从CDN Pro边缘节点服务器中删除缓存对象。缓存删除之后,当边缘服务器收到本次删除内容文件的请求时,由于CDN Pro上已没有对应的缓存,无法直接响应文件给用户,此时便会直接回源的源站服务器检索文件。
强制过期:将CDN Pro边缘节点服务器中的缓存对象标记为过期,但是不会删除节点上的缓存内容。缓存强制过期后,当边缘服务器收到本次强制过期内容文件的请求时,会对比源站对应文件的版本,若源站文件版本比节点缓存文件版本更新时,CDN Pro节点才会回源站服务器检索该文件;如果源站无法访问,则CDN Pro 边缘服务器可以继续为您的终端用户提供旧的缓存文件内容。系统默认选择强制过期的刷新方式。
刷新类型 选择要刷新类型,可以是单文件刷新、通配符匹配刷新多个缓存内容、正则表达式匹配刷新指定内容。默认类型为文件刷新。其中:
文件:指定单个文件刷新,一个文件对应一条URL。注意:如果一个文件由于配置了自定义缓存健(Cache Key )而存在多个缓存版本,请使用请选择目录刷新。
目录:指定刷新某个目录下的文件/目录,支持输入通配符来指定刷新的内容。当您需要删除目录文件时可以采用此刷新类型。详见:目录(通配符)刷新
正则:指的是采用正则表达式来搜索匹配刷新内容。当文件刷新和目录刷新无法满足您的需求时,可采用此刷新类型。详见:正则刷新
添加要刷新的文件 填写指定刷新的文件内容URL信息。您可以直接在输入框按照指定格式填写刷新内容,也可以在txt文件中填写完成后直接拖拽导入填写框。其中:
●当选择 “刷新类型” = “文件” 时,请输入要刷新的文件的完整 URL(例如:http://test.domain1.com/1.txt 、http://test.domain2.com/2.txt?q1=1&q2=3)。需要刷新多个则输入多个URL,以回车键分隔。
●当选择 “刷新类型” = “目录” 时,请按照指定的通配符语法格式输入指定刷新文件。CDN Pro支持基于URL前缀的刷新、支持制定刷新目录及其子目录,详见:目录(通配符)刷新
●当选择 “刷新类型” = “正则” 时,请按照指定的正则表达式语法格式输入指定刷新文件。详见:正则刷新
添加文件刷新请求头 当选择 “刷新类型” = “文件” 时,可选填写此部分信息。若您要刷新的文件URL设置了通过请求头来区分缓存键(Cache key),可以在此处添加HTTP请求头来指定需要刷新的缓存版本。您可点击“添加”按钮新增一条HTTP头部配置,若您想移除对应的配置,可以点击操作类的删除(如何打造云课堂智慧教学平台)按钮来移除请求头配置。
●示例:某个文件URL,当自定义了一个请求头X-Version,值为1或者2,并且您根据该头部设置了不同版本的响应文件内容。此时,您想刷新版本2的文件内容,则可以添加一个名称为“X-Version”、值为“2”的文件刷新请求头信息。
  1. 提交刷新。表单页左下角“开始刷新”按钮,提交内容刷新任务。

  2. 查看刷新结果。刷新任务提交完成后,您可返回刷新任务列表页查看任务刷新结果。您还可以查看刷新任务详情或重新提交刷新

温馨说明:CDN Pro会动态控制加速节点服务器文件/目录刷新并发数,以进行节点自保,保障加速加速性能优先。您在创建刷新任务的时候可以在控制台上看到当前可刷新的文件额度/目录额度。当任务下发执行完成后,CDN Pro会逐渐自动释放刷新额度。其中:

  • 每日初始额度:文件10000个;目录/正则共40个;
  • 每日最大可释放额度:文件5000个;目录/正则共20个。
  • 单次任务可提交额度:文件1000个;目录20个;正则2个。

目录(通配符)刷新

CDN Pro 允许您通过指定目录的方式来刷新整个目录下的文件。您可以在 URL 中输入通配符以制定刷新的目录。基本规则如下:

  • 子目录结尾以单个星号(*)结束,仅刷新本目录层级下的所有文件。
  • 目录结尾以两个星号(*)结束,将刷新本目录层级和子目录层级下的所有文件。
  • URL结尾以拓展名结束(*.ext),则刷新所有具有指定扩展名的文件。
  • 刷新 URL 中包含百分比字符号(%),则将需要将其进行编码转换为 %25 。

注意: 如果您在边缘逻辑中配置了自定义缓存键(Cache Key),或者通过配置Vary头部等方式来区分缓存,那么同一个 URL 文件可能会存在多个不同的缓存文件版本,例如: /pictures/ 或 /picture.jpg 均会缓存多个版本文件。因此,如果您执行不带星号的目录刷新,则会刷新掉除该目录下的所有文件版本,但是不刷新其子目录下的文件;如。如果您配置了 /pictures/、/pictures/* 和 /pictures/** 的目录刷新任务,将会得到不同的刷新结果。

下表是目录刷新的配置示例:

序号
配置示例
说明
1 http://test.domain2.com/mydir 刷新单个URL文件的所有缓存版本,但不刷新其子目录或文件。如果您在配置中使用了自定义缓存键,则同一个URL可能存在不同缓存版本,所有版本将一同被刷新。
2 http://test.domain2.com/mydir/** 刷新所有以 http://test.domain2.com/mydir/ 开头的缓存文件及其子目录下的文件。
3 http://test.domain2.com/mydir/* 刷新mydir目录下的所有文件,但不刷新其子目录下的文件。
4 http://test.domain2.com/mydir/*.jpg 刷新所有以 .jpg 文件扩展名结尾的缓存文件。 http://test.domain2.com/mydir/ 的子目录不会被清除。
5 http://test.domain2.com/mydir/a* 刷新所有以字母“a”开头的文件,但不清除其子目录。
6 http://test.domain2.com/mydir/a** 刷新所有以字母“a”开头的文件和子目录。
7 http://test.domain2.com/mydir/a.jpg 刷新“a.jpg”的所有缓存版本。如果您在配置中使用了自定义缓存键,则同一个URL可能存在不同缓存版本,所有版本将一同被刷新。
8 http://test.domain2.com/my**jpg 刷新缓存键以 http://test.domain2.com/my 开头并以后缀 jpg 结尾的所有缓存文件。 “**”可以匹配路径中的任何内容,包括子目录。例如,http://test.domain2.com/mydirectory/picture.jpg 将被刷新。

正则刷新

CDN Pro 允许您通过正则表达式来匹配缓存键,以此指定要您要刷新的文件内容。基本规则如下:

  • 正则表达式必须以 {scheme}://{hostname} 开头,其中 {scheme} 是指 http、https 或其他请求协议类型。例如:https://test.domain.com/my.*\.(jpg|png)\?q=
  • hostname后面的正则表达式长度应小于 126字符。
  • 最多可以包含两个无限量词(“*”、“+”或",}")
  • 任何量词的上限不能超过59。

查看刷新任务详细信息

1、在控制台内容刷新页面下,点击所选刷新任务的任务ID字段,进入刷新任务详情页。

2、刷新任务详细信息的图示及说明如下:

如何打造云课堂智慧教学平台

序号
关键元素
说明
1 刷新任务基础信息 展示刷新任务的基础信息,包括:
●任务状态:本次刷新任务的执行结果,为 成功 / 失败 / 等待 / 刷新中。
●目标环境:本次刷新任务下发的环境,为 生产环境 /演练环境。
●刷新方式:本次刷新任务的内容刷新方式,是直接删除内容还是使其过期无效。
●开始时间:本次刷新任务提交的时间。
●结束时间:本次刷新任务执行完成的时间。
2 刷新内容详情 展示被刷新文件/目录/正则表达式详情,包括:
●文件总数:本次任务刷新的文件/目录总数。
●刷新列表:本次任务刷新的详细文件列表/目录列表/正则表达式。
3 再次刷新 当您不想重新创建一个新的刷新任务时,可以基于已有的任务,在任务详情页由下方点击“再次刷新”按钮,以再提提交刷新任务。当刷新成功率未达100%的时候,建议您直接此处重新尝试刷新。
本篇文档内容对您是否有帮助?
有帮助
没帮助
提交成功!非常感谢您的反馈,我们会继续努力做到更好!