通过 Dynamic Media 使 CDN 缓存失效 invalidating-cdn-cache-for-dm-assets-in-aem-cs

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

NOTE
此功能要求您使用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失效模板 页面上,根据您的场景执行以下选项之一:

    table 0-row-2 1-row-2 2-row-2
    方案 选项
    我以前使用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将基于此路径通过下列方式形成URL <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失效模板 — 创建

    note note
    NOTE
    CDN失效模板最多可保存2500个字符的文本。
  3. 在右上角 CDN失效模板 页面,选择 保存,然后选择 确定.

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

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

    CDN验证功能

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

    CDN失效 — 添加详细信息

    note note
    NOTE
    如果您决定保留这些选项 使CDN中与资产关联的图像预设失效 基于模板失效 如果取消选中,则会形成选定资源的基本URL以进行失效。 仅对图像使用此选项排列。
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    选项 描述
    使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右侧的URL,用于从失效进程中删除它。

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

CDN失效错误疑难解答

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

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