通过 Dynamic Media 使 CDN 缓存失效

上次更新: 2023-05-26
  • 创建对象:
  • Admin
    User

Dynamic Media资产通过CDN(内容分发网络)缓存,以便快速交付给客户。 但是,当您更新这些资产时,希望这些更改立即在您的网站上生效。 通过清除或使CDN缓存失效,可快速更新Dynamic Media交付的资源。 您不再需要等待TTL(生存时间)值(默认为10小时)使缓存过期。 相反,您可以在Dynamic Media用户界面中发送请求,以使缓存在几分钟内过期。

注意

此功能要求您使用Adobe Experience Manager Dynamic Media随附的Adobe捆绑的CDN。 此功能不支持任何其他自定义CDN。

如果已启用 智能成像 如果您使用的是Adobe捆绑的CDN,则可以通过清除单个基本URL来清除所有包含不同查询字符串的URL。

例如,使无效 https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image,也会使以下URL失效:

  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image
  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image?wid=300
  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image?$PLP$
  • 依此类推.

但是,这种失效不适用于不支持智能成像的通用域,例如 s7d1.scene7.com. 此类域仍需要完整URL才能成功失效。

要通过Dynamic Media使CDN缓存失效,请执行以下操作:

第1部分(共2部分):创建CDN失效模板

  1. 在Adobe Experience Manager as a Cloud Service中,转到 工具 > 资产 > CDN失效模板.

    CDN验证功能

  2. CDN失效模板 页面,根据您的方案执行以下选项之一:

    方案 选项
    我以前使用Dynamic Media Classic创建过CDN失效模板。 创建模板 文本字段已预填充了您的模板数据。 在这种情况下,您可以编辑模板或继续下一步骤。
    我必须创建一个模板。 我该输入什么? 创建模板 文本字段,输入引用图像URL(包括图像预设或修饰符) <ID>,而不是下面的示例中所述的特定图像ID:
    https://my.publishserver.com/is/image/company_name/<ID>?$product$
    如果模板仅包含 <ID>,然后Dynamic Media填充 https://<publishserver_name>/is/image/<company_name>/<ID> 位置 <publishserver_name> 是在Dynamic Media Classic的“常规设置”中定义的发布服务器的名称。 此 <company_name> 是与此Experience Manager实例关联的公司根的名称,并且 <ID> 是通过要失效的资产选取器选定的资产。
    以下任何预设/修饰符 <ID> 在URL定义中按原样复制。
    只有图像,也就是说, /is/image — 可以根据模板自动形成。
    对象 /is/content/,使用资源选取器添加视频或PDF等资源不会自动生成URL。 相反,您必须在CDN失效模板中指定此类资源,或者可以手动将URL添加到中的此类资源 第2部分(共2部分):设置CDN失效选项.
    示例:
    ​在第一个示例中,失效模板包含 <ID> 以及资源URL /is/content. 例如, http://my.publishserver.com:8080/is/content/dms7snapshot/<ID>. Dynamic Media基于此路径通过 <ID> 是要使其失效的通过资产选取器选定的资产。
    在第二个示例中,失效模板包含Web属性中使用的资产的完整URL,其中 /is/content (不依赖于资产选取器)。 例如, http://my.publishserver.com:8080/is/content/dms7snapshot/backpack 其中,backpack是资产ID。
    Dynamic Media中支持的资源格式符合失效条件。 资源文件类型 支持CDN失效的功能包括PostScript®、封装PostScript®、Adobe Illustrator、Adobe InDesign、Microsoft®Powerpoint、Microsoft®Excel、Microsoft®Word和富文本格式。

    ·创建模板时,请务必注意语法和拼写错误;Dynamic Media不执行任何模板验证。
    · CDN失效模板最多可保存2500个字符的文本。
    ·在此CDN失效模板中或在 添加URL 中的文本字段 第2部分:设置CDN失效选项。
    · CDN失效模板中的每个条目必须位于其自己的行上。
    ·以下CDN失效模板示例仅用于演示目的。

    CDN失效模板 — 创建

    注意

    CDN失效模板最多可保存2500个字符的文本。

  3. CDN失效模板 页面,选择 保存,然后选择 确定.

    第2部分(共2部分):设置CDN失效选项

  4. 在Experience Manageras a Cloud Service中,转到 工具 > 资产 > CDN失效.

    CDN验证功能

  5. CDN失效 - 添加详细信息 页面中,选择要使CDN失效的资产。

    CDN失效 — 添加详细信息

    注意

    如果您决定保留选项 使CDN中与资产关联的图像预设失效 基于模板失效 如果未选中,则会形成选定资产的基本URL以进行失效。 仅对图像使用此选项排列。

    选项 描述
    使 CDN 中与资产关联的图像预设失效 (可选)选中此选项后,会自动形成所选资源及其所有相关图像预设URL,以便使缓存失效。
    资产及其关联的预定义预设URL会自动形成以便失效。 此选项仅适用于图像资产。
    基于模板失效 (可选)选中此选项可仅使用定义的模板来构建URL。
    添加资产 使用资产选取器选择要使其失效的资产。 您可以选择已发布或已取消发布的资源。
    CDN上的缓存基于URL,而不是基于资产。 因此,您必须了解您网站上的完整URL。 确定这些URL后,可以将其添加到模板中。 然后,您可以选择并添加这些资源,并在一个步骤中使URL失效。
    将此选项与 使CDN中与资产关联的图像预设失效,或 基于模板失效,或同时使用两者。
    添加 URL 手动将完整URL路径添加或粘贴到要使CDN缓存失效的Dynamic Media资源。 如果您没有在中创建CDN失效模板,请使用此选项 第1部分(共2部分):创建CDN失效模板,并且只有少数资产可失效。
    重要提示: 您添加的每个URL都必须位于其自身的行中。
    在给定时间内,最多可以使1000个URL失效。 如果 添加URL 文本字段大于1000,您无法选择 下一个. 在这种情况下,您必须选择 X 右侧的选定资源或手动添加的URL以将其从失效列表中删除。
    在CDN失效模板中或在此模板中指定图像智能裁剪的URL 添加URL 文本字段。
  6. 在页面的右上角附近,选择 下一个.

  7. CDN失效 - 确认 页面,在 URL 列表框中,您将看到一个列表,其中包含从您之前创建的CDN失效模板生成的一个或多个URL以及您刚刚添加的资源。

    例如,使用前面步骤中显示的CDN失效模板示例,假设您添加了一个名为的资产 spinset. 当您转到 工具 > 资产 > CDN失效,它会在中生成以下五个URL CDN失效 — 确认 用户界面:

    CDN失效 — 确认

    如有必要,请选择 X URL的右侧,以将其从失效进程中删除。

  8. 在页面的右上角附近,选择 提交 以开始CDN失效过程。

CDN失效错误疑难解答

在所有情况下,要么处理整个批次以使其失效,要么整个批次失败。

错误 解释
无法检索选定资产的URL。 如果满足以下任一方案,则发生:
— 未找到Dynamic Media配置。
— 检索用于读取Dynamic Media配置的服务用户时出现异常。
- Dynamic Media配置中缺少用于形成URL的发布服务器或公司根目录。
未正确定义某些URL。 更正并重新提交。 在IPS CDN缓存失效API返回错误时发生。 根据IPS cdnCacheInvalidation API进行的验证,该错误指示URL引用了其他公司或URL无效。
无法使CDN缓存失效。 在CDN缓存失效请求由于任何其他原因失败时发生。
没有输入要失效的URL。 如果中不存在URL,则会发生 CDN失效 - 确认 页面,然后选择 提交.

在此页面上