通过 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中,转到​ 工具 > Assets > CDN失效模板

    CDN验证功能

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

    table 0-row-2 1-row-2 2-row-2
    场景 选项
    我以前使用Dynamic Media Classic创建过CDN失效模板。 创建模板 ​文本字段已预填充您的模板数据。 在这种情况下,您可以编辑模板或继续下一步骤。
    我必须创建一个模板。 我该输入什么? 在​ 创建模板 ​文本字段中,输入引用<ID>的图像URL(包括图像预设或修饰符),而不是以下示例中所述的特定图像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的“常规设置”中定义的Publish服务器的名称。 <company_name>是与此Experience Manager实例关联的公司根的名称,而<ID>是通过资产选取器选定的要失效的资产。
    在URL定义中按原样复制<ID>之后的任何预设/修饰符。
    只能基于模板自动形成图像(即/is/image)。
    对于/is/content/,使用资源选取器添加视频或PDF等资源不会自动生成URL。 而是必须在CDN失效模板中指定此类资源,或者可以在​ 第2部分(共2部分):设置CDN失效选项 ​中手动将URL添加到此类资源。
    示例:
    ​在第一个示例中,失效模板包含<ID>以及具有/is/content的资产URL。 例如,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,其中背包是资产ID。
    Dynamic Media支持的资源格式符合失效条件。 CDN失效不支持​ ​资源文件类型包括PostScript®、封装式PostScript®、Adobe Illustrator、Adobe InDesign、Microsoft®Powerpoint、Microsoft®Excel、Microsoft®Word和富文本格式。

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

    CDN失效模板 — 创建

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

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

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

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

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

    CDN失效 — 确认

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

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

CDN失效错误疑难解答

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

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