Freigeben über


Tutorial: Hinzufügen eines Azure Content Delivery Network zu einer Azure App Service-Web-App

Wichtig

Azure CDN Standard von Microsoft (klassisch) wird am 30. September 2027 eingestellt. Um Dienstunterbrechungen zu vermeiden, ist es wichtig, dass Sie Ihre Profile von Azure CDN Standard von Microsoft (klassisch) bis zum 30. September 2027 auf die Dienstebene Azure Front Door Standard oder Premium migrieren. Weitere Informationen finden Sie unter Einstellung von Azure CDN Standard von Microsoft (klassisch).

In diesem Tutorial wird veranschaulicht, wie Sie Azure Content Delivery Network einer Web-App in Azure App Service hinzufügen. Web-Apps sind Dienste zum Hosten von Webanwendungen, REST-APIs und mobilen Back-Ends.

Hier ist die Startseite der statischen HTML-Beispielwebsite dargestellt, mit der Sie arbeiten werden:

Startseite der Beispiel-App

Lerninhalt:

  • Erstellen eines Azure CDN-Endpunkts.
  • Aktualisieren von zwischengespeicherten Objekten
  • Verwenden von Abfragezeichenfolgen zum Steuern von zwischengespeicherten Versionen

Voraussetzungen

Für dieses Tutorial benötigen Sie Folgendes:

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

Erstellen der Web-App

Folgen Sie zum Erstellen der Web-App, mit der Sie arbeiten, der Anleitung unter Erstellen einer statischen HTML-Web-App in Azure in fünf Minuten bis zum Schritt Navigieren zur App.

Melden Sie sich auf dem Azure-Portal an.

Öffnen Sie einen Browser, und melden Sie sich beim Azure-Portal an.

Optimieren der Beschleunigung dynamischer Websites

Wenn Sie Ihren Content Delivery Network-Endpunkt für die Beschleunigung dynamischer Websites (Dynamic Site Acceleration, DSA) optimieren möchten, sollten Sie Ihr Profil und Ihren Endpunkt über das Content Delivery Network-Portal erstellen. Durch die DSA-Optimierung wird die Leistung von Webseiten mit dynamischen Inhalten merklich verbessert. Wie Sie einen Content Delivery Network-Endpunkt über das Content Delivery Network-Portal für DSA optimieren, erfahren Sie unter Beschleunigung dynamischer Websites durch das Azure Content Delivery Network. Falls Sie Ihren neuen Endpunkt nicht optimieren möchten, können Sie ihn gemäß der Anleitung im nächsten Abschnitt über das Web-App-Portal erstellen. Bei Azure CDN von Edgio-Profilen können Sie nach deren Erstellung die Optimierung eines Content Delivery Network-Endpunkts nicht ändern.

Erstellen eines Content Delivery Network-Profils und -Endpunkts

Wählen Sie im Navigationsbereich auf der linken Seite die Option App Services und dann die App aus, die Sie unter Erstellen einer statischen HTML-Web-App in Azure in fünf Minuten erstellt haben.

Screenshot von „Auswählen einer App Service-App“ im Portal

Wählen Sie auf der Seite App Service im Abschnitt Einstellungen die Option Netzwerk > Azure CDN aus.

Screenshot: Auswählen von Azure Content Delivery Network aus der Einstellung „Netzwerk“ eines App Service.

Geben Sie auf der Seite Azure Content Delivery Network die Einstellungen für Neuer Endpunkt gemäß den Angaben in der Tabelle an.

Screenshot: Erstellen eines Azure Content Delivery Network-Profils und -Endpunkts im Portal.

Einstellung Vorgeschlagener Wert Beschreibung
Content Delivery Network-Profile myCDNProfile Ein Content Delivery Network-Profil ist eine Sammlung von Content Delivery Network-Endpunkten mit demselben Preisniveau.
Preisstufe Microsoft Content Delivery Network (klassisch) Über den Tarif werden der Anbieter und die verfügbaren Features angegeben.
Name des Content Delivery Network-Endpunkts Beliebiger Name, der in der Domäne „azureedge.net“ eindeutig ist Sie greifen auf Ihre zwischengespeicherten Ressourcen in der Domäne <Endpunktname> .azureedge.net zu.

Wählen Sie Erstellen aus, um ein Content Delivery Network-Profile zu erstellen.

Azure erstellt das Profil und den Endpunkt. Der neue Endpunkt wird in der Liste Endpunkte angezeigt. Nach seiner Bereitstellung lautet der Status Wird ausgeführt.

Screenshot des neuen Azure Content Delivery Network-Endpunkts in der Liste.

Testen des Content Delivery Network-Endpunkts

Der Endpunkt kann nicht sofort verwendet werden, da die Verteilung der Registrierung über das CDN eine Weile dauern kann:

  • Bei Profilen vom Typ Azure CDN Standard von Microsoft (klassisch) ist die Weitergabe in der Regel in zehn Minuten abgeschlossen.
  • Bei Profilen vom Typ Azure CDN Standard von Edgio und Azure CDN Premium von Edgio ist die Weitergabe in der Regel innerhalb von 90 Minuten abgeschlossen.

Die Beispiel-App enthält die Datei index.html und die Ordner css, img und js mit anderen statischen Objekten. Die Inhaltspfade für alle diese Dateien sind am Content Delivery Network-Endpunkt identisch. Beispielsweise wird mit beiden folgenden URLs auf die Datei bootstrap.css im Ordner css zugegriffen:

http://<appname>.azurewebsites.net/css/bootstrap.css

http://<endpointname>.azureedge.net/css/bootstrap.css

Navigieren Sie in einem Browser zur folgenden URL:

http://<endpointname>.azureedge.net/index.html

Screenshot der Beispiel-App-Homepage, die vom Content Delivery Network bereitgestellt wird.

Daraufhin wird die Seite angezeigt, die Sie zuvor in einer Azure-Web-App ausgeführt haben. Das Azure Content Delivery Network hat die Ressourcen der Ursprungsweb-App abgerufen und vom Content Delivery Network-Endpunkt bereitgestellt

Aktualisieren Sie die Seite, um sicherzustellen, dass diese Seite im Content Delivery Network zwischengespeichert wird. Es kann sein, dass für ein Objekt zwei Anforderungen erforderlich sind, damit der angeforderte Inhalt vom Content Delivery Network zwischengespeichert wird.

Weitere Informationen zum Erstellen von Azure Content Delivery Network-Profilen und -Endpunkten finden Sie unter Erste Schritte mit Azure Content Delivery Network.

Content Delivery Network bereinigen

Das Content Delivery Network aktualisiert basierend auf der Gültigkeitsdauer (Time To Live, TTL) in regelmäßigen Abständen seine Ressourcen der ursprünglichen Web-App. Die Standardgültigkeitsdauer ist sieben Tage.

Es kann vorkommen, dass Sie das Content Delivery Network vor Ablauf der Gültigkeitsdauer aktualisieren müssen, z.B. beim Bereitstellen von aktualisiertem Inhalt für die Web-App. Zum Auslösen einer Aktualisierung bereinigen Sie die Content Delivery Network-Ressourcen manuell.

In diesem Abschnitt des Tutorials stellen Sie eine Änderung für die Web-App bereit und bereinigen das Content Delivery Network, um für das Content Delivery Network die Aktualisierung des Caches auszulösen.

Bereitstellen einer Änderung für die Web-App

Öffnen Sie die Datei index.html, und fügen Sie der Überschrift H1 den Zusatz - V2 hinzu. Dies ist im folgenden Beispiel dargestellt:

<h1>Azure App Service - Sample Static HTML Site - V2</h1>

Übernehmen Sie die Änderung, und stellen Sie sie für die Web-App bereit.

git commit -am "version 2"
git push azure main

Navigieren Sie nach Abschluss der Bereitstellung zur Web-App-URL. Die Änderung wird angezeigt.

http://<appname>.azurewebsites.net/index.html

„V2“ im Titel der Web-App

Wenn Sie zur Content Delivery Network-Endpunkt-URL für die Startseite navigieren, werden die Änderungen nicht angezeigt, weil die zwischengespeicherte Version im Content Delivery Network noch nicht abgelaufen ist.

http://<endpointname>.azureedge.net/index.html

Screenshot von

Content Delivery Network im Portal bereinigen

Um das Content Delivery Network zum Aktualisieren der zwischengespeicherten Version auszulösen, bereinigen Sie das Content Delivery Network.

Wählen Sie im Navigationsbereich links im Portal die Option Ressourcengruppen und dann die Ressourcengruppe aus, die Sie für Ihre Web-App (myResourceGroup) erstellt haben.

Screenshot: Auswählen der Ressourcengruppe im linken Menübereich im Portal

Wählen Sie in der Liste der Ressourcen ihren Content Delivery Network-Endpunkt aus.

Screenshot des Azure Content Delivery Network-Endpunkts aus der Ressourcengruppe.

Wählen Sie oben auf der Seite Endpunkt die Option Bereinigen aus.

Screenshot der Schaltfläche „Bereinigen“ in einem Azure Content Delivery Network-Profil.

Geben Sie die Inhaltspfade ein, die Sie bereinigen möchten. Sie können einen vollständigen Dateipfad übergeben, um eine einzelne Datei zu bereinigen, oder ein Pfadsegment, um den gesamten Inhalt eines Ordners zu bereinigen und zu aktualisieren. Da Sie index.html geändert haben, stellen Sie sicher, dass sich die Datei unter einem der Pfade befindet.

Wählen Sie am unteren Rand der Seite die Option Bereinigen.

Screenshot der Seite „Bereinigen“ in einem Azure Content Delivery Network-Profil.

Überprüfen Sie, ob das Content Delivery Network aktualisiert wird

Warten Sie, bis die Verarbeitung der Bereinigungsanforderung abgeschlossen ist. Dies dauert normalerweise einige Minuten. Wählen Sie zum Anzeigen des aktuellen Status oben auf der Seite das Glockensymbol.

Screenshot der Bereinigungsbenachrichtigung für ein Azure Content Delivery Network-Profil.

Wenn Sie zur Content Delivery Network-Endpunkt-URL für index.html navigieren, sehen Sie den Zusatz V2, den Sie dem Titel auf der Startseite hinzugefügt haben. Dies bedeutet, dass der Content Delivery Network-Cache aktualisiert wurde.

http://<endpointname>.azureedge.net/index.html

Screenshot von V2 im Titel des Content Delivery Network.

Weitere Informationen finden Sie unter Bereinigen eines Azure Content Delivery Network-Endpunkts.

Verwenden von Abfragezeichenfolgen zum Versehen von Inhalt mit einer Version

Azure Content Delivery Network verfügt über die folgenden Optionen für das Zwischenspeicherverhalten:

  • Ignorieren von Abfragezeichenfolgen
  • Umgehen der Zwischenspeicherung für Abfragezeichenfolgen
  • Zwischenspeichern jeder eindeutigen URL

Die erste Option ist die Standardeinstellung. Sie bedeutet, dass es nur eine zwischengespeicherte Version eines Objekts gibt, und zwar unabhängig von der Abfragezeichenfolge in der URL.

In diesem Abschnitt des Tutorials ändern Sie das Zwischenspeicherverhalten, sodass jede eindeutige URL zwischengespeichert wird.

Ändern des Cacheverhaltens

Wählen Sie im Azure-Portal auf der Seite CDN-Endpunkt die Option Cache.

Wählen Sie in der Dropdownliste Verhalten für das Zwischenspeichern von Abfragezeichenfolgen die Option Jede eindeutige URL zwischenspeichern.

Wählen Sie Speichern.

Screenshot der Zwischenspeicherungsregeleinstellungen für ein Azure Content Delivery Network-Profil.

Sicherstellen der separaten Zwischenspeicherung eindeutiger URLs

Navigieren Sie in einem Browser zur Startseite des Content Delivery Network-Endpunkts, und binden Sie dabei eine Abfragezeichenfolge ein:

http://<endpointname>.azureedge.net/index.html?q=1

Azure Content Delivery Network gibt den aktuellen Inhalt der Web-App zurück, der in der Überschrift den Zusatz V2 enthält.

Aktualisieren Sie die Seite, um sicherzustellen, dass diese Seite im Content Delivery Network zwischengespeichert wird.

Öffnen Sie index.html, ändern Sie V2 in V3, und stellen Sie dann die Änderung bereit.

git commit -am "version 3"
git push azure main

Navigieren Sie in einem Browser mit einer neuen Abfragezeichenfolge, z.B. q=2, zur Content Delivery Network-Endpunkt-URL. Azure Content Delivery Network ruft die aktuelle Datei index.html ab und zeigt V3 an. Wenn Sie dagegen mit der Abfragezeichenfolge q=1 zum Content Delivery Network-Endpunkt navigieren, wird V2 angezeigt.

http://<endpointname>.azureedge.net/index.html?q=2

Screenshot von V3 im Titel des Content Delivery Network, Abfragezeichenfolge 2.

http://<endpointname>.azureedge.net/index.html?q=1

Screenshot von V2 im Titel des Content Delivery Network, Abfragezeichenfolge 1.

Diese Ausgabe veranschaulicht, dass jede Abfragezeichenfolge anders behandelt wird:

  • q=1 wurden zuvor verwendet, weshalb zwischengespeicherte Inhalte zurückgegeben werden (V2).
  • q=2 ist neu, weshalb die neuesten Web-App-Inhalte abgerufen und zurückgegeben werden (V3).

Weitere Informationen finden Sie unter Steuern des Zwischenspeicherungsverhaltens des Azure Content Delivery Network mit Abfragezeichenfolgen.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, löschen Sie die Ressourcengruppe, indem Sie den folgenden Befehl in Cloud Shell ausführen:

az group delete --name myResourceGroup

Die Ausführung dieses Befehls kann eine Minute in Anspruch nehmen.

Nächste Schritte

Sie haben Folgendes gelernt:

  • Erstellen eines Azure CDN-Endpunkts.
  • Aktualisieren von zwischengespeicherten Objekten
  • Verwenden von Abfragezeichenfolgen zum Steuern von zwischengespeicherten Versionen

Die folgenden Artikel enthalten Informationen zur Optimierung der Content Delivery Network-Leistung: