Hosten einer statischen Website in Azure Storage

Sie können statische Inhalte (HTML, CSS, JavaScript und Bilddateien) direkt aus einem Container in einem allgemeinen V2- oder BlockBlobStorage-Konto bereitstellen. Weitere Informationen finden Sie unter Statisches Websitehosting in Azure Storage.

In diesem Artikel erfahren Sie, wie Sie statisches Websitehosting mithilfe des Azure-Portals, der Azure CLI oder PowerShell aktivieren.

Aktivieren des Hostings statischer Websites

Statisches Websitehosting ist ein Feature, das Sie für das Speicherkonto aktivieren müssen.

Portal

1. Melden Sie sich beim Azure-Portal an, um zu beginnen.

2. Suchen Sie Ihr Speicherkonto, und wählen Sie es aus, um den Übersichtsbereich des Kontos anzuzeigen.

3. Wählen Sie im Bereich "Übersicht " die Registerkarte "Funktionen " aus. Wählen Sie als Nächstes "Statische Website " aus, um die Konfigurationsseite für die statische Website anzuzeigen.

   

4. Wählen Sie "Aktiviert" aus, um statisches Websitehosting für das Speicherkonto zu aktivieren.

5. Geben Sie im Feld "Indexdokumentname " eine Standardindexseite an (z. B. index.html).

   Die Standardindexseite wird angezeigt, wenn ein Benutzer zum Stammverzeichnis Ihrer statischen Website navigiert.

6. Geben Sie im Feld "Pfad des Fehlerdokuments " eine Standardfehlerseite an (z. B. 404.html).

   Die Standardfehlerseite wird angezeigt, wenn ein Benutzer versucht, zu einer Seite zu navigieren, die in Ihrer statischen Website nicht vorhanden ist.

7. Klicken Sie auf "Speichern ", um die Konfiguration der statischen Website abzuschließen.

   

8. Eine Bestätigungsmeldung wird angezeigt. Ihre statischen Websiteendpunkte und andere Konfigurationsinformationen werden im Bereich "Übersicht " angezeigt.

   

Azure CLI

Sie können statisches Websitehosting mithilfe der Azure CLI aktivieren.

1. Öffnen Sie zunächst Azure Cloud Shell, oder falls Sie die Azure-CLI lokal installiert haben, öffnen Sie eine Befehlskonsolenanwendung wie Windows PowerShell.

2. Wenn Ihre Identität mehreren Abonnements zugeordnet ist, legen Sie das aktive Abonnement auf das Abonnement des Speicherkontos fest, auf dem Ihre statische Website gehostet wird.

   az account set --subscription <subscription-id>
   

   Ersetzen Sie den Platzhalterwert <subscription-id> durch die ID Ihres Abonnements.

3. Aktivieren Sie statisches Websitehosting.

   az storage blob service-properties update --account-name <storage-account-name> --static-website --404-document <error-document-name> --index-document <index-document-name>
   

   • Ersetzen Sie den Platzhalterwert <storage-account-name> durch den Namen Ihres Speicherkontos.

   • Ersetzen Sie den <error-document-name> Platzhalter durch den Namen des Fehlerdokuments, das Benutzern angezeigt wird, wenn ein Browser eine Seite auf Ihrer Website anfordert, die nicht vorhanden ist.

   • Ersetzen Sie den <index-document-name> Platzhalter durch den Namen des Indexdokuments. Dieses Dokument ist häufig "index.html".

PowerShell

Sie können statisches Websitehosting mithilfe des Azure PowerShell-Moduls aktivieren.

1. Öffnen Sie ein Windows PowerShell-Befehlsfenster.

2. Vergewissern Sie sich, dass Sie über das Azure PowerShell-Modul Az, Version 0.7 oder höher, verfügen.

   Get-InstalledModule -Name Az -AllVersions | select Name,Version
   

   Informationen zum Installieren oder Upgrade finden Sie unter Installieren des Azure PowerShell-Moduls.

3. Melden Sie sich mit dem Befehl Connect-AzAccount bei Ihrem Azure-Abonnement an, und befolgen Sie die Anweisungen auf dem Bildschirm.

   Connect-AzAccount
   

4. Wenn Ihre Identität mehreren Abonnements zugeordnet ist, legen Sie das aktive Abonnement auf das Abonnement des Speicherkontos fest, auf dem Ihre statische Website gehostet wird.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Ersetzen Sie den Platzhalterwert <subscription-id> durch die ID Ihres Abonnements.

5. Rufen Sie den Kontext des Speicherkontos ab, der das zu verwendende Speicherkonto definiert.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Ersetzen Sie den Platzhalterwert <resource-group-name> durch den Namen Ihrer Ressourcengruppe.

   • Ersetzen Sie den Platzhalterwert <storage-account-name> durch den Namen Ihres Speicherkontos.

6. Aktivieren Sie statisches Websitehosting.

   Enable-AzStorageStaticWebsite -Context $ctx -IndexDocument <index-document-name> -ErrorDocument404Path <error-document-name>
   

   • Ersetzen Sie den <error-document-name> Platzhalter durch den Namen des Fehlerdokuments, das Benutzern angezeigt wird, wenn ein Browser eine Seite auf Ihrer Website anfordert, die nicht vorhanden ist.

   • Ersetzen Sie den <index-document-name> Platzhalter durch den Namen des Indexdokuments. Dieses Dokument ist häufig "index.html".

Dateien hochladen

Portal

Die folgenden Anweisungen zeigen, wie Sie Dateien mithilfe des Azure-Portals hochladen. Sie können auch AzCopy, PowerShell, CLI oder eine beliebige benutzerdefinierte Anwendung verwenden, die Dateien in den container $web Ihres Kontos hochladen kann. Ein schrittweises Lernprogramm, das Dateien mithilfe von Visual Studio-Code hochlädt, finden Sie unter Lernprogramm: Hosten einer statischen Website im Blob Storage.

1. Navigieren Sie im Azure-Portal zu dem Speicherkonto, das Ihre statische Website enthält. Wählen Sie "Container" im linken Navigationsbereich aus, um die Liste der Container anzuzeigen.

2. Wählen Sie im Bereich "Container " den $web Container aus, um den Übersichtsbereich des Containers zu öffnen.

   

3. Wählen Sie im Bereich "Übersicht " das Symbol "Hochladen " aus, um den Blobbereich "Hochladen " zu öffnen. Wählen Sie als Nächstes das Feld "Dateien " im Bereich "Blob hochladen " aus, um den Dateibrowser zu öffnen. Navigieren Sie zu der Datei, die Sie hochladen möchten, wählen Sie sie aus, und wählen Sie dann "Öffnen " aus, um das Feld "Dateien " aufzufüllen. Aktivieren Sie optional das Kontrollkästchen "Überschreiben", wenn dateien bereits vorhanden sind .

   

4. Wenn Sie beabsichtigen, dass der Browser den Inhalt der Datei darstellt, stellen Sie sicher, dass der Inhaltstyp dieser Datei auf text/html eingestellt ist. Um dies zu überprüfen, wählen Sie den Namen des Blobs aus, den Sie im vorherigen Schritt hochgeladen haben, um den Bereich "Übersicht " zu öffnen. Stellen Sie sicher, dass der Wert innerhalb des INHALTSTYP-Eigenschaftenfelds festgelegt ist.

   

   Hinweis

   Diese Eigenschaft wird automatisch auf text/html für häufig erkannte Erweiterungen wie .html festgelegt, z. B. . In einigen Fällen müssen Sie dies jedoch selbst festlegen. Wenn Sie diese Eigenschaft nicht auf text/html festlegen, fordert der Browser die Benutzer auf, die Datei herunterzuladen, anstatt den Inhalt darzustellen. Diese Eigenschaft kann im vorherigen Schritt festgelegt werden.

Azure CLI

Laden Sie Objekte aus einem Quellverzeichnis in den container $web hoch.

In diesem Beispiel wird davon ausgegangen, dass Sie Befehle aus der Azure Cloud Shell-Sitzung ausführen.

az storage blob upload-batch -s <source-path> -d '$web' --account-name <storage-account-name>

Hinweis

Wenn der Browser die Benutzer auffordert, die Datei herunterzuladen, anstatt den Inhalt zu rendern, können Sie --content-type 'text/html; charset=utf-8' an den Befehl anhängen.

• Ersetzen Sie den Platzhalterwert <storage-account-name> durch den Namen Ihres Speicherkontos.

• Ersetzen Sie den <source-path> Platzhalter durch einen Pfad zum Speicherort der Dateien, die Sie hochladen möchten.

Hinweis

Wenn Sie eine Standortinstallation von Azure CLI verwenden, können Sie den Pfad zu einem beliebigen Speicherort auf Ihrem lokalen Computer verwenden (z. B.: C:\myFolder.

Wenn Sie Azure Cloud Shell verwenden, müssen Sie auf eine Dateifreigabe verweisen, die für die Cloud Shell sichtbar ist. Dieser Speicherort kann die Dateifreigabe der Cloudfreigabe selbst sein oder eine vorhandene Dateifreigabe, die Sie aus Cloud Shell bereitstellen. Informationen zur Vorgehensweise finden Sie unter Beibehalten von Dateien in Azure Cloud Shell.

PowerShell

Laden Sie Objekte aus einem Quellverzeichnis in den container $web hoch.

# upload a file
set-AzStorageblobcontent -File "<path-to-file>" `
-Container `$web `
-Blob "<blob-name>" `
-Context $ctx

Hinweis

Wenn der Browser die Benutzer auffordert, die Datei herunterzuladen, anstatt den Inhalt zu rendern, können Sie -Properties @{ ContentType = "text/html; charset=utf-8";} an den Befehl anhängen.

• Ersetzen Sie den <path-to-file> Platzhalterwert durch den vollqualifizierten Pfad zu der Datei, die Sie hochladen möchten (z. B.: C:\temp\index.html).

• Ersetzen Sie den <blob-name> Platzhalterwert durch den Namen, den Sie dem resultierenden Blob zuweisen möchten (z. B.: index.html).

Website-URL suchen

Sie können die Seiten Ihrer Website über einen Browser anzeigen, indem Sie die öffentliche URL der Website verwenden.

Portal

Wählen Sie im Bereich, der neben der Kontoübersichtsseite Ihres Speicherkontos angezeigt wird, "Statische Website" aus. Die URL Ihrer Website wird im Feld "Primärer Endpunkt " angezeigt.

Azure CLI

Suchen Sie die öffentliche URL Ihrer statischen Website mithilfe des folgenden Befehls:

az storage account show -n <storage-account-name> -g <resource-group-name> --query "primaryEndpoints.web" --output tsv

• Ersetzen Sie den Platzhalterwert <storage-account-name> durch den Namen Ihres Speicherkontos.

• Ersetzen Sie den Platzhalterwert <resource-group-name> durch den Namen Ihrer Ressourcengruppe.

PowerShell

Suchen Sie die öffentliche URL Ihrer statischen Website mithilfe des folgenden Befehls:

 $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -Name "<storage-account-name>"
Write-Output $storageAccount.PrimaryEndpoints.Web

• Ersetzen Sie den Platzhalterwert <resource-group-name> durch den Namen Ihrer Ressourcengruppe.

• Ersetzen Sie den Platzhalterwert <storage-account-name> durch den Namen Ihres Speicherkontos.

Aktivieren von Metriken auf statischen Websiteseiten

Nachdem Sie Metriken aktiviert haben, werden Datenverkehrsstatistiken zu Dateien im Container $web im Dashboard für Metriken gemeldet.

1. Klicken Sie im Abschnitt "Überwachen" im Menü "Speicherkonto" auf "Metriken".

   

   Hinweis

   Metrikdaten werden durch Verknüpfen mit verschiedenen Metrik-APIs generiert. Das Portal zeigt nur API-Elemente an, die innerhalb eines bestimmten Zeitraums verwendet werden, um sich nur auf Elemente zu konzentrieren, die Daten zurückgeben. Um sicherzustellen, dass Sie das erforderliche API-Mitglied auswählen können, besteht der erste Schritt darin, den Zeitrahmen zu erweitern.

2. Klicken Sie auf die Schaltfläche für den Zeitrahmen, wählen Sie einen Zeitrahmen aus, und klicken Sie dann auf Übernehmen.

   

3. Wählen Sie "Blob " aus der Dropdownliste "Namespace " aus.

   

4. Wählen Sie dann die Metrik Ausgehend aus.

   

5. Wählen Sie Summe aus dem Aggregationsmenü aus.

   

6. Klicken Sie auf die Schaltfläche " Filter hinzufügen ", und wählen Sie den API-Namen aus der Eigenschaftenauswahl aus.

   

7. Aktivieren Sie das Kontrollkästchen neben "GetWebContent " in der Werteauswahl , um den Metrikbericht aufzufüllen.

   

   Hinweis

   Das Kontrollkästchen "GetWebContent " wird nur angezeigt, wenn dieses API-Mitglied innerhalb eines bestimmten Zeitraums verwendet wurde. Das Portal zeigt nur API-Elemente an, die innerhalb eines bestimmten Zeitraums verwendet werden, um sich nur auf Elemente zu konzentrieren, die Daten zurückgeben. Wenn Sie in dieser Liste kein bestimmtes API-Mitglied finden können, erweitern Sie den Zeitrahmen.

Nächste Schritte

• Erfahren Sie, wie Sie eine benutzerdefinierte Domäne mit Ihrer statischen Website konfigurieren. Siehe Zuordnen einer benutzerdefinierten Domäne zu einem Azure Blob Storage-Endpunkt.