Invalidierung des CDN-Cache über Dynamic Media

Dynamic Media-Assets werden vom CDN (Content Delivery Network) zwischengespeichert, um eine schnelle Bereitstellung an Ihre Kunden zu ermöglichen. Wenn Sie diese Assets aktualisieren, wollen Sie jedoch möglicherweise, dass die Änderungen auf Ihrer Website sofort wirksam werden. Durch Löschen oder Invalidierung des CDN-Cache können Sie von Dynamic Media bereitgestellte Assets schnell aktualisieren. Anstatt darauf warten zu müssen, dass der Cache mit einem TTL-Wert (Time To Live) abläuft (Standardwert: 10 Stunden), können Sie in der Benutzeroberfläche von Dynamic Media eine Anfrage senden, damit der Cache innerhalb von Minuten abläuft.

WICHTIG

Die folgenden Schritte gelten nur für den Dynamic Media - Scene7-Modus in AEM 6.5, Service Pack 6 (AEM 6.5.6) oder höher. Für diese Funktion zur Ungültigmachung von CDN müssen Sie auch das im Lieferumfang von AEM Dynamic Media enthaltene Out-of-the-Box-CDN verwenden. andere benutzerdefinierte CDN werden nicht unterstützt.
Wenn Sie Dynamic Media in AEM 6.5, Service Pack 5 (AEM 6.5.5) oder früher verwenden, befolgen Sie die Schritte unter Ungültigmachen des CDN-Cache mithilfe von Dynamic Media Classic.

Siehe auch Übersicht über Caching in Dynamic Media.

So machen Sie Ihre im CDN-Cache gespeicherten Inhalte für Dynamic Media-Assets ungültig:

Teil 1 von 2: Erstellen einer Vorlage für die CDN-Invalidierung

  1. Tippen Sie in AEM 6.5.6 oder höher auf Werkzeuge > Assets > CDN-Ungültigmachung.

    CDN-Validierungsfunktion

  2. Führen Sie auf der Seite mit der Vorlage für CDN-Invalidierung je nach Ihrem Szenario eine der folgenden Optionen aus:

    Szenario Option
    Ich habe mit Dynamic Media Classic bereits früher eine Vorlage für CDN-Invalidierung erstellt. Das Textfeld Vorlage erstellen wird vorab mit Ihren Vorlagendaten ausgefüllt. In diesem Fall können Sie entweder die Vorlage bearbeiten oder mit dem nächsten Schritt fortfahren.
    Ich muss eine Vorlage erstellen. Was gebe ich ein? Geben Sie im Textfeld Vorlage erstellen anstelle einer bestimmten Bild-ID eine Bild-URL ein (einschließlich Bildvorgaben oder Modifikatoren), die auf <ID> verweist. Dies wird im folgenden Beispiel dargestellt:
    https://my.publishserver.com/is/image/company_name/<ID>?$product$
    Wenn die Vorlage nur <ID> enthält, füllt Dynamic Media https://<publishserver_name>/is/image/<company_name>/<ID> aus, wobei <publishserver_name> der Name Ihres Veröffentlichungs-Servers ist, der in den allgemeinen Einstellungen von Dynamic Media Classic definiert ist. Der <company_name> ist der Name des Stammordners Ihres Unternehmens, der dieser AEM-Instanz zugeordnet ist; <ID> sind die Assets, die über die Asset-Auswahl zur Invalidierung ausgewählt wurden.
    Alle Vorgaben/Modifikatoren <ID> werden im Istzustand in die URL-Definition kopiert.
    Nur Bilder - also /is/image - können automatisch basierend auf der Vorlage erstellt werden.
    Wenn bei /is/content/ mit der Asset-Auswahl Assets wie Videos oder PDFs hinzugefügt werden, werden keine automatischen URLs generiert. Stattdessen müssen Sie diese Assets entweder in der Vorlage für CDN-Invalidierung angeben oder die URL den Assets manuell hinzufügen in Teil 2 von 2: Festlegen von CDN-Invalidierungsoptionen.
    Beispiele:
    In diesem ersten Beispiel enthält die Vorlage für die Invalidierung <ID> zusammen mit der Asset-URL, die /is/content aufweist. Beispiel: http://my.publishserver.com:8080/is/content/dms7snapshot/<ID>. Dynamic Media bildet die URL auf dieser Grundlage, wobei es sich bei <ID> um die über die Asset-Auswahl gewählten Assets handelt, die ungültig gemacht werden sollen.
    In diesem zweiten Beispiel enthält die Vorlage für die Invalidierung die vollständige URL des Assets, das in Ihren Web-Eigenschaften verwendet wird, mit /is/content (unabhängig von der Asset-Auswahl). Beispiel: http://my.publishserver.com:8080/is/content/dms7snapshot/backpack, wobei „backpack“ die Asset-ID ist.
    Asset-Formate, die in Dynamic Media unterstützt werden, können ungültig gemacht werden. Zu den Asset-Dateitypen, die bei der CDN-Invalidierung nicht unterstützt werden, zählen PostScript, Encapsulated PostScript, Adobe Illustrator, Adobe InDesign, Microsoft PowerPoint, Microsoft Excel, Microsoft Word und Rich Text Format.
    Achten Sie beim Erstellen der Vorlage genau auf Syntax und mögliche Rechtschreibfehler. Dynamic Media nimmt keine Vorlagenüberprüfung vor.
    Beachten Sie, dass Sie URLs für das intelligente Zuschneiden von Bildern entweder in dieser Vorlage für CDN-Invalidierung oder im Textfeld URL hinzufügen in Teil 2: Einrichten von CDN-Invalidierungsoptionen angeben müssen.
    Wichtig: Jeder Eintrag in einer Vorlage für CDN-Invalidierung muss sich in einer eigenen Zeile befinden.
    Das folgende Vorlagenbeispiel dient nur zur Veranschaulichung.

    Vorlage für CDN-Invalidierung – Erstellen

  3. Tippen Sie in der rechten oberen Ecke der Seite Vorlage für CDN-Invalidierung auf Speichern und dann auf OK.

    Teil 2 von 2: Einrichten von CDN-Invalidierunsoptionen

  4. Tippen Sie in AEM as a Cloud Service auf Tools> Assets > CDN-Invalidierung.

    CDN-Validierungsfunktion

  5. Wählen Sie auf der Seite CDN-Ungültigmachung - Hinzufügen Details die Assets für die Ungültigmachung des CDN aus.

    CDN-Invalidierung – Details hinzufügen

    HINWEIS

    Wenn Sie die Optionen Invalidierungs-Asset hat Bildvorgaben in CDN zugeordnet und Invalidierung anhand von Vorlage deaktiviert lassen, wird zur Invalidierung die Basis-URL der ausgewählten Assets gebildet. Sie sollten diese Option nur für Bilder verwenden.

    Option Beschreibung
    Invalidierungs-Asset hat Bildvorgaben in CDN zugeordnet (Optional) Wenn Sie diese Option aktivieren, werden ausgewählte Assets und alle zugehörigen Bildvorgabe-URLs für die Cache-Invalidierung automatisch gebildet.
    Assets und die zugehörigen vordefinierten Vorgabe-URLs werden für die Invalidierung automatisch erstellt. Diese Option funktioniert nur bei Bild-Assets.
    Invalidierung anhand von Vorlage (Optional) Aktivieren Sie diese Option, um nur die definierte Vorlage für die URL-Bildung zu verwenden.
    Assets hinzufügen Verwenden Sie die Asset-Auswahl, um Assets auszuwählen, die ungültig gemacht werden sollen. Sie können entweder veröffentlichte Assets oder Assets auswählen, deren Veröffentlichung rückgängig gemacht wurde.
    Die Zwischenspeicherung im CDN erfolgt URL-basiert und nicht Asset-basiert. Daher müssen Sie sich der vollständigen URLs auf Ihrer Website bewusst sein. Nachdem Sie die URLs ermittelt haben, können Sie sie der Vorlage hinzufügen. Anschließend können Sie die Assets auswählen und die URLs in einem Schritt ungültig machen.
    Verwenden Sie diese Option zusammen mit Invalidierungs-Asset hat Bildvorgaben in CDN zugeordnet, Invalidierung anhand von Vorlage oder beiden.
    URL hinzufügen Fügen Sie für Dynamic Media-Assets, deren CDN-Cache Sie ungültig machen möchten, manuell vollständige URL-Pfade hinzu oder fügen Sie sie ein. Nutzen Sie diese Option, wenn Sie in Teil 1 von 2: Erstellen einer Vorlage für CDN-Invalidierung eine Vorlage für CDN-Invalidierung erstellt haben und nur über einige Assets zur Invalidierung verfügen.
    Wichtig: Jede URL, die Sie hinzufügen, muss sich in einer eigenen Zeile befinden.
    Sie können bis zu 1.000 URLs auf einmal ungültig machen. Wenn die Anzahl der URLs im Textfeld URL hinzufügen höher als 1.000 ist, können Sie nicht auf Weiter tippen. In dem Fall müssen Sie rechts neben einem ausgewählten Asset oder einer manuell hinzugefügten URL auf X tippen, um das Asset oder die URL aus der Liste für die Invalidierung zu löschen.
    Beachten Sie, dass Sie URLs für Bilder mit intelligentem Zuschnitt entweder in der Vorlage für CDN-Invalidierung oder im Textfeld URL hinzufügen angeben müssen.
  6. Tippen Sie oben rechts auf Weiter.

  7. Auf der Seite Ungültigmachen des CDN - Bestätigen wird im Feld URLs Liste eine Liste von einer oder mehreren URLs angezeigt, die aus der zuvor erstellten Vorlage zur Ungültigmachung des CDN und den soeben hinzugefügten Assets generiert wurden.

    Nehmen wir zum Beispiel an, dass Sie mit der Vorlage für CDN-Invalidierung, die in den vorherigen Schritten beschrieben wurde, ein Asset namens spinset hinzugefügt haben. Wenn Sie auf Tools > Assets > CDN-Invalidierung tippen, werden die folgenden fünf generierten URLs in der Benutzeroberfläche CDN-Invalidierung – Bestätigen angezeigt:

    CDN-Invalidierung – Bestätigen

    Falls erforderlich, tippen Sie rechts neben einer URL auf X, um sie aus dem Invalidierungsprozess zu entfernen.

  8. Tippen Sie in der rechten oberen Ecke der Seite auf Übermitteln, um die CDN-Invalidierung zu starten.

Behebung von Fehlern bei der CDN-Invalidierung

In jedem Fall wird entweder der gesamte Batch zur Invalidierung verarbeitet oder schlägt der gesamte Batch fehl.

Fehler Erklärung
URLs für ausgewählte Assets konnten nicht abgerufen werden. Tritt auf, wenn eines der folgenden Szenarien erfüllt ist:
- Eine Dynamic Media-Konfiguration wurde nicht gefunden.
- Beim Abrufen eines Dienstbenutzers, über den die Dynamic Media-Konfiguration gelesen wird, gibt es eine Ausnahme.
- Der Veröffentlichungs-Server bzw. Stammordner des Unternehmens, der zum Erstellen der URLs verwendet wird, fehlt in der Dynamic Media-Konfiguration.
Einige URLs sind nicht richtig definiert. Bitte korrigieren und übermitteln Sie sie erneut. Tritt auf, wenn die IPS CDN-Cache-Invalidierungs-API einen Fehler zurückgibt, dass die URL auf ein anderes Unternehmen verweist, oder die URL laut der von der IPS cdnCacheInvalidation-API durchgeführten Überprüfung ungültig ist.
CDN-Cache konnte nicht ungültig gemacht werden. Tritt auf, wenn die Anfrage zur Invalidierung des CDN-Cache aus einem anderen Grund fehlschlägt.
Keine Angabe von URLs, die ungültig gemacht werden sollen. Tritt auf, wenn auf der Seite CDN-Ungültigmachung - Bestätigen keine URLs vorhanden sind, und Sie auf Senden. tippen

Auf dieser Seite