Hostování statického webu ve službě Azure Storage

Článek
05/11/2023

Statický obsah (SOUBORY HTML, CSS, JavaScript a obrázky) můžete obsluhovat přímo z kontejneru v účtu pro obecné účely verze 2 nebo BlockBlobStorage . Další informace najdete v tématu Hostování statického webu ve službě Azure Storage.

V tomto článku se dozvíte, jak povolit hostování statických webů pomocí Azure Portal, Azure CLI nebo PowerShellu.

Povolení hostování statických webů

Hostování statického webu je funkce, kterou musíte v účtu úložiště povolit.

Začněte tím, že se přihlásíte k Azure Portal.
Vyhledejte svůj účet úložiště a vyberte ho, aby se zobrazilo podokno Přehled účtu.
V podokně Přehled vyberte kartu Schopnosti . Dále vyberte Statický web , aby se zobrazila stránka konfigurace statického webu.
Vyberte Povoleno a povolte hostování statického webu pro účet úložiště.
Do pole Název dokumentu rejstříku zadejte výchozí stránku indexu (například :index.html).

Výchozí indexová stránka se zobrazí, když uživatel přejde do kořenového adresáře vašeho statického webu.
V poli Cesta k chybě zadejte výchozí chybovou stránku (například :404.html).

Výchozí chybová stránka se zobrazí, když se uživatel pokusí přejít na stránku, která na vašem statickém webu neexistuje.
Kliknutím na Uložit dokončete konfiguraci statické lokality.
Zobrazí se potvrzovací zpráva. Koncové body statického webu a další informace o konfiguraci se zobrazují v podokně Přehled .

Hostování statických webů můžete povolit pomocí Azure CLI.

Nejprve otevřete azure Cloud Shell nebo pokud jste místně nainstalovali Azure CLI, otevřete aplikaci příkazové konzoly, například Windows PowerShell.
Pokud je vaše identita přidružená k více než jednomu předplatnému, nastavte aktivní předplatné na předplatné účtu úložiště, který bude hostovat váš statický web.
```
az account set --subscription <subscription-id>
```
<subscription-id> Nahraďte hodnotu zástupného symbolu ID vašeho předplatného.
Povolte hostování statických webů.
```
az storage blob service-properties update --account-name <storage-account-name> --static-website --404-document <error-document-name> --index-document <index-document-name>
```
- <storage-account-name> Zástupnou hodnotu nahraďte názvem vašeho účtu úložiště.
- <error-document-name> Zástupný symbol nahraďte názvem dokumentu s chybou, který se zobrazí uživatelům, když prohlížeč požádá o stránku na vašem webu, která neexistuje.
- <index-document-name> Zástupný symbol nahraďte názvem dokumentu rejstříku. Tento dokument je obvykle "index.html".

Hostování statických webů můžete povolit pomocí modulu Azure PowerShell.

Otevřete Windows PowerShell příkazové okno.
Ověřte, že máte Azure PowerShell modul Az verze 0.7 nebo novější.
```
Get-InstalledModule -Name Az -AllVersions | select Name,Version
```
Pokud potřebujete instalaci nebo upgrade, přečtěte si téma Instalace modulu Azure PowerShell.
Přihlaste se ke svému předplatnému Azure pomocí příkazu Connect-AzAccount a postupujte podle pokynů na obrazovce.
```
Connect-AzAccount
```
Pokud je vaše identita přidružená k více než jednomu předplatnému, nastavte aktivní předplatné na předplatné účtu úložiště, který bude hostovat váš statický web.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
<subscription-id> Nahraďte hodnotu zástupného symbolu ID vašeho předplatného.
Získejte kontext účtu úložiště, který definuje účet úložiště, který chcete použít.
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- Hodnotu zástupného symbolu <resource-group-name> nahraďte názvem vaší skupiny prostředků.
- <storage-account-name> Zástupnou hodnotu nahraďte názvem vašeho účtu úložiště.
Povolte hostování statických webů.
```
Enable-AzStorageStaticWebsite -Context $ctx -IndexDocument <index-document-name> -ErrorDocument404Path <error-document-name>
```
- <error-document-name> Zástupný symbol nahraďte názvem dokumentu s chybou, který se zobrazí uživatelům, když prohlížeč požádá o stránku na vašem webu, která neexistuje.
- <index-document-name> Zástupný symbol nahraďte názvem dokumentu rejstříku. Tento dokument je obvykle "index.html".

Nahrání souborů

Následující pokyny ukazují, jak nahrát soubory pomocí Azure Portal. Můžete také použít AzCopy, PowerShell, rozhraní příkazového řádku nebo jakoukoli vlastní aplikaci, která může nahrávat soubory do kontejneru $web vašeho účtu. Podrobný kurz, který nahraje soubory pomocí editoru Visual Studio Code, najdete v tématu Kurz: Hostování statického webu ve službě Blob Storage.

V Azure Portal přejděte na účet úložiště obsahující váš statický web. V levém navigačním podokně vyberte Kontejnery , abyste zobrazili seznam kontejnerů.
V podokně Kontejnery výběrem kontejneru $web otevřete podokno Přehled kontejneru.
V podokně Přehled výběrem ikony Nahrát otevřete podokno Nahrát objekt blob . Potom výběrem pole Soubory v podokně Nahrát objekt blob otevřete prohlížeč souborů. Přejděte k souboru, který chcete nahrát, vyberte ho a pak výběrem možnosti Otevřít vyplňte pole Soubory . Volitelně můžete zaškrtnout políčko Přepsat, pokud už soubory existují .
Pokud chcete, aby prohlížeč zobrazoval obsah souboru, ujistěte se, že je typ obsahu tohoto souboru nastavený na text/htmlhodnotu . Pokud to chcete ověřit, vyberte název objektu blob, který jste nahráli v předchozím kroku, a otevřete podokno Přehled . Ujistěte se, že je hodnota nastavená v poli vlastnosti CONTENT-TYPE .

Poznámka

Tato vlastnost je automaticky nastavena na text/html pro běžně rozpoznaná rozšíření, jako .htmlje . V některých případech si to ale budete muset nastavit sami. Pokud tuto vlastnost nenastavíte na text/html, prohlížeč místo vykreslení obsahu vyzve uživatele ke stažení souboru. Tuto vlastnost je možné nastavit v předchozím kroku.

Nahrajte objekty do kontejneru $web ze zdrojového adresáře.

V tomto příkladu se předpokládá, že spouštíte příkazy z relace Azure Cloud Shell.

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

Poznámka

Pokud prohlížeč vyzve uživatele ke stažení souboru místo vykreslení obsahu, můžete k příkazu připojit --content-type 'text/html; charset=utf-8' .

<storage-account-name> Zástupnou hodnotu nahraďte názvem vašeho účtu úložiště.
<source-path> Zástupný symbol nahraďte cestou k umístění souborů, které chcete nahrát.

Poznámka

Pokud používáte umístění instalace Azure CLI, můžete použít cestu k libovolnému umístění v místním počítači (například: C:\myFolder.

Pokud používáte Azure Cloud Shell, budete muset odkazovat na sdílenou složku, která je viditelná pro Cloud Shell. Tímto umístěním může být sdílená složka samotné cloudové sdílené složky nebo existující sdílená složka, kterou připojíte z Cloud Shell. Postup najdete v tématu Zachování souborů v Azure Cloud Shell.

Nahrajte objekty do kontejneru $web ze zdrojového adresáře.

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

Poznámka

Pokud prohlížeč vyzve uživatele ke stažení souboru místo vykreslení obsahu, můžete k příkazu připojit -Properties @{ ContentType = "text/html; charset=utf-8";} .

Nahraďte hodnotu zástupného <path-to-file> symbolu plně kvalifikovanou cestou k souboru, který chcete nahrát (například ). C:\temp\index.html
<blob-name> Nahraďte hodnotu zástupného symbolu názvem, který chcete dát výslednému objektu blob (příklad: index.html).

Vyhledání adresy URL webu

Stránky webu můžete zobrazit v prohlížeči pomocí veřejné adresy URL webu.

V podokně, které se zobrazí vedle stránky s přehledem účtu úložiště, vyberte Statický web. Adresa URL vašeho webu se zobrazí v poli Primární koncový bod .

Metrika metrik statických webů Azure Storage

Pomocí následujícího příkazu vyhledejte veřejnou adresu URL statického webu:

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

<storage-account-name> Zástupnou hodnotu nahraďte názvem vašeho účtu úložiště.
Hodnotu zástupného symbolu <resource-group-name> nahraďte názvem vaší skupiny prostředků.

Pomocí následujícího příkazu vyhledejte veřejnou adresu URL statického webu:

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

Hodnotu zástupného symbolu <resource-group-name> nahraďte názvem vaší skupiny prostředků.
<storage-account-name> Zástupnou hodnotu nahraďte názvem vašeho účtu úložiště.

Povolení metrik na statických webových stránkách

Po povolení metrik se na řídicím panelu metrik hlásí statistika provozu u souborů v kontejneru $web .

V nabídce účtu úložiště klikněte na Metriky v části Monitorování .

Poznámka

Data metrik se generují propojením různých rozhraní API metrik. Portál zobrazuje jenom členy rozhraní API použité v daném časovém rámci, aby se mohli zaměřit pouze na členy, kteří vracejí data. Abyste měli jistotu, že budete moct vybrat potřebného člena rozhraní API, je prvním krokem rozšíření časového rámce.
Klikněte na tlačítko časového rámce, zvolte časový rámec a pak klikněte na Použít.
V rozevíracím seznamu Obor názvů vyberte Objekt blob.
Pak vyberte metriku Výchozí přenos dat .
Ve výběru Agregace vyberte Součet.
Klikněte na tlačítko Přidat filtr a ze selektoru vlastnosti zvolte Název rozhraní API.
Pokud chcete naplnit sestavu metrik, zaškrtněte políčko vedle GetWebContent v selektoru Hodnoty .

Poznámka

Zaškrtávací políčko GetWebContent se zobrazí pouze v případě, že byl tento člen rozhraní API použit v daném časovém rámci. Portál zobrazuje jenom členy rozhraní API použité v daném časovém rámci, aby se mohli zaměřit pouze na členy, kteří vracejí data. Pokud v tomto seznamu nemůžete najít konkrétního člena rozhraní API, rozbalte časový rámec.