Share via


Cachebereinigung in Azure Front Door mit der Azure CLI

Azure Front Door speichert Ressourcen zwischen, bis deren Gültigkeitsdauer (Time-to-live, TTL) abläuft. Wenn ein Client eine Ressource nach Ablauf ihrer Gültigkeitsdauer anfordert, ruft die Azure Front Door-Umgebung eine neue aktualisierte Kopie der Ressource ab, um die Anforderung zu erfüllen und den aktualisierten Cache zu speichern.

Es empfiehlt sich, sicherzustellen, dass die Benutzer immer die neueste Kopie Ihrer Ressourcen erhalten. Zu diesem Zweck erstellen Sie Versionen für die einzelnen Aktualisierungen der Ressourcen und veröffentlichen sie als neue URLs. Azure Front Door Standard/Premium ruft sofort die neuen Ressourcen für die nächsten Clientanforderungen ab. Manchmal möchten Sie möglicherweise zwischengespeicherten Inhalt aus allen Edgeknoten löschen und sie zwingen, neue aktualisierte Assets abzurufen. Sie möchten zwischengespeicherten Inhalt löschen, weil Sie neue Updates Ihrer Anwendung durchgeführt haben oder Ressourcen aktualisieren möchten, die falsche Informationen enthalten.

Voraussetzungen

  • Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.

  • Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

    • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.

    • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.

    • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

Konfigurieren der Cachebereinigung

Führen Sie az afd endpoint purge aus, um den Cache zu bereinigen, nachdem Sie die erforderlichen Parameter eingegeben haben, z. B.:

  • Name der Ressourcengruppe

  • Name des Azure Front Door-Profils in der Ressourcengruppe mit Ressourcen, das Sie bereinigen möchten

  • Endpunkte mit Ressourcen, die Sie bereinigen möchten

  • Domänen/Unterdomänen mit Ressourcen, die Sie bereinigen möchten

    Wichtig

    Die Cachebereinigung für Platzhalterdomänen wird nicht unterstützt. Sie müssen eine Unterdomäne für die Cachebereinigung für eine Platzhalterdomäne angeben. Sie können beliebig viele Unterdomänen mit einer einzelnen Ebene der Platzhalterdomäne hinzufügen. Beispielsweise können Sie für die Platzhalterdomäne *.afdxgatest.azfdtest.xyzUnterdomänen in Form von contoso.afdxgatest.azfdtest.xyz oder cart.afdxgatest.azfdtest.xyz usw. hinzufügen. Weitere Informationen finden Sie unter Platzhalterdomänen in Azure Front Door.

  • Der Pfad zu dem Inhalt, der bereinigt werden soll.

    • Diese Formate werden in der Liste der zu löschenden Pfade unterstützt:
      • Löschen eines einzelnen Pfads: Löschen Sie einzelne Ressourcen, indem Sie den vollständigen Pfad der Ressource, ohne Protokoll und Domäne, aber mit der Dateierweiterung angeben. Beispiel: „/pictures/strasbourg.png“.
      • Löschen der Stammdomäne: Löschen Sie den Stamm des Endpunkts, indem Sie „/*“ im Pfad angeben.
az afd endpoint purge \
   --resource-group myRGFD \
   --profile-name contosoafd \
   --endpoint-name myendpoint \
   --domains www.contoso.com \
   --content-paths '/scripts/*'

Bei Cachebereinigungen im Azure Front Door-Profil wird die Groß-/Kleinschreibung nicht beachtet. Darüber hinaus sind Cachebereinigungen abfragezeichenfolgenagnostisch, d. h. beim Bereinigen einer URL werden alle Abfragezeichenfolgenvariationen der URL gelöscht.

Hinweis

Es kann bis zu 10 Minuten dauern, bis die Cache-Löschung im gesamten Netzwerk und an alle Edge-Standorte verteilt ist.

Nächste Schritte

Erfahren Sie, wie Sie ein Azure Front Door-Profil erstellen.