Ospitare un sito Web statico in Archiviazione di Azure

È possibile gestire contenuto statico (file HTML, CSS, JavaScript e image) direttamente da un contenitore in un account V2 o BlockBlobStorage per utilizzo generico. Per maggiori informazioni, vedere Hosting di siti Web statici in Archiviazione di Azure.

Questo articolo illustra come abilitare l'hosting di siti Web statici usando il portale di Azure, l'interfaccia della riga di comando di Azure o PowerShell.

Abilitare l'hosting di siti Web statici

L'hosting di siti Web statici è una funzionalità che è necessario abilitare nell'account di archiviazione.

Portale

1. Accedere al portale di Azure per iniziare.

2. Individuare l'account di archiviazione e selezionarlo per visualizzare il riquadro Panoramica dell'account.

3. Nel riquadro Panoramica selezionare la scheda Funzionalità . Selezionare quindi Sito Web statico per visualizzare la pagina di configurazione per il sito Web statico.

   

4. Selezionare Attivato per attivare l'hosting di siti web statici per l'account di archiviazione.

5. Nel campo Nome documento indice specificare una pagina di indice predefinita , ad esempio index.html.

   La pagina di indice predefinita viene visualizzata quando un utente passa alla radice del sito Web statico.

6. Nel campo Percorso documento errore specificare una pagina di errore predefinita , ad esempio 404.html.

   La pagina di errore predefinita viene visualizzata quando un utente tenta di passare a una pagina che non esiste nel sito Web statico.

7. Fare clic su Salva per completare la configurazione del sito statico.

   

8. Viene visualizzato un messaggio di conferma. Gli endpoint del sito Web statico e altre informazioni di configurazione vengono visualizzati nel riquadro Panoramica .

   

Interfaccia della riga di comando di Azure

È possibile abilitare l'hosting di siti Web statici usando l'interfaccia della riga di comando di Azure.

1. Prima di tutto aprire Azure Cloud Shell oppure un'applicazione console dei comandi come Windows PowerShell, se si dispone dell’interfaccia della riga di comando di Azure installata in locale.

2. Se la propria identità è associata a più sottoscrizioni, impostare come sottoscrizione attiva quella dell’account di archiviazione destinato a ospitare il sito Web statico.

   az account set --subscription <subscription-id>
   

   Sostituire il valore segnaposto <subscription-id> con l'ID della sottoscrizione.

3. Abilitare l'hosting di siti Web statici.

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

   • Sostituire il valore segnaposto <storage-account-name> con il nome del proprio account di archiviazione.

   • Sostituire il <error-document-name> segnaposto con il nome del documento di errore che verrà visualizzato agli utenti quando un browser richiede una pagina nel sito che non esiste.

   • Sostituire il <index-document-name> segnaposto con il nome del documento di indice. Questo documento è comunemente "index.html".

PowerShell

È possibile abilitare l'hosting di siti Web statici usando il modulo Azure PowerShell.

1. Aprire una finestra dei comandi di Windows PowerShell.

2. Verificare di avere il modulo Azure PowerShell Az versione 0.7 o successiva.

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

   Se è necessario installare o aggiornare, vedere Installare il modulo Azure PowerShell.

3. Accedere alla sottoscrizione di Azure con il comando Connect-AzAccount e seguire le istruzioni visualizzate.

   Connect-AzAccount
   

4. Se la propria identità è associata a più sottoscrizioni, impostare come sottoscrizione attiva quella dell’account di archiviazione destinato a ospitare il sito Web statico.

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

   Sostituire il valore segnaposto <subscription-id> con l'ID della sottoscrizione.

5. Ottenere il contesto dell’account di archiviazione che definisce l'account di archiviazione che si intende usare.

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

   • Sostituire il valore segnaposto <resource-group-name> con il nome del proprio gruppo di risorse.

   • Sostituire il valore segnaposto <storage-account-name> con il nome del proprio account di archiviazione.

6. Abilitare l'hosting di siti Web statici.

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

   • Sostituire il <error-document-name> segnaposto con il nome del documento di errore che verrà visualizzato agli utenti quando un browser richiede una pagina nel sito che non esiste.

   • Sostituire il <index-document-name> segnaposto con il nome del documento di indice. Questo documento è comunemente "index.html".

Carica i file

Portale

Le istruzioni seguenti illustrano come caricare i file usando il portale di Azure. È anche possibile usare AzCopy, PowerShell, l'interfaccia della riga di comando o qualsiasi applicazione personalizzata in grado di caricare file nel contenitore $web dell'account. Per un'esercitazione dettagliata che carica i file usando Visual Studio Code, vedere Esercitazione: Ospitare un sito Web statico in Archiviazione BLOB.

1. Nel portale di Azure passare all'account di archiviazione contenente il sito Web statico. Selezionare Contenitori nel riquadro di spostamento sinistro per visualizzare l'elenco dei contenitori.

2. Nel riquadro Contenitori selezionare il contenitore $web per aprire il riquadro Panoramica del contenitore.

   

3. Nel riquadro Panoramica, selezionare l'icona Carica per aprire il riquadro Carica blob. Selezionare quindi il campo File nel riquadro Carica BLOB per aprire il browser file. Passare al file da caricare, selezionarlo e quindi selezionare Apri per popolare il campo File . Facoltativamente, selezionare la casella di controllo Sovrascrivi se i file esistono già .

   

4. Se si intende che il browser visualizzi il contenuto del file, assicurarsi che il tipo di contenuto di tale file sia impostato su text/html. Per verificarlo, selezionare il nome del BLOB caricato nel passaggio precedente per aprire il relativo riquadro Panoramica . Assicurarsi che il valore sia impostato all'interno del campo proprietà CONTENT-TYPE .

   

   Annotazioni

   Questa proprietà viene impostata automaticamente su text/html per le estensioni comunemente riconosciute, .htmlad esempio . Tuttavia, in alcuni casi, dovrai impostarlo manualmente. Se non si imposta questa proprietà su text/html, il browser chiederà agli utenti di scaricare il file anziché eseguire il rendering del contenuto. Questa proprietà può essere impostata nel passaggio precedente.

Interfaccia della riga di comando di Azure

Caricare oggetti nel contenitore $web da una directory di origine.

Questo esempio presuppone che si eseguano comandi dalla sessione di Azure Cloud Shell.

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

Annotazioni

Se il browser richiede agli utenti di scaricare il file invece di eseguire il rendering del contenuto, è possibile aggiungere --content-type 'text/html; charset=utf-8' al comando .

• Sostituire il valore segnaposto <storage-account-name> con il nome del proprio account di archiviazione.

• Sostituire il segnaposto <source-path> con il percorso alla posizione dei file da caricare.

Annotazioni

Se si utilizza un'installazione locale dell'Azure CLI, è possibile usare il percorso di qualsiasi directory sul computer locale, ad esempio . C:\myFolder

Se si usa Azure Cloud Shell, è necessario fare riferimento a una condivisione file visibile a Cloud Shell. Questo percorso può essere la condivisione file della condivisione cloud stessa o una condivisione file esistente che si monta da Cloud Shell. Per informazioni su come eseguire questa operazione, vedere Rendere persistenti i file in Azure Cloud Shell.

PowerShell

Caricare oggetti nel contenitore $web da una directory di origine.

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

Annotazioni

Se il browser richiede agli utenti di scaricare il file invece di eseguire il rendering del contenuto, è possibile aggiungere -Properties @{ ContentType = "text/html; charset=utf-8";} al comando .

• Sostituire il <path-to-file> valore segnaposto con il percorso completo del file da caricare , ad esempio . C:\temp\index.html

• Sostituire il <blob-name> valore segnaposto con il nome che si vuole assegnare al BLOB risultante (ad esempio: index.html).

Trovare l'URL del sito Web

È possibile visualizzare le pagine del sito da un browser usando l'URL pubblico del sito Web.

Portale

Nel riquadro visualizzato accanto alla pagina di panoramica dell'account dell'account di archiviazione selezionare Sito Web statico. L'URL del tuo sito viene visualizzato nel campo Endpoint primario .

Interfaccia della riga di comando di Azure

Trovare l'URL pubblico del sito Web statico usando il comando seguente:

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

• Sostituire il valore segnaposto <storage-account-name> con il nome del proprio account di archiviazione.

• Sostituire il valore segnaposto <resource-group-name> con il nome del proprio gruppo di risorse.

PowerShell

Trovare l'URL pubblico del sito Web statico usando il comando seguente:

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

• Sostituire il valore segnaposto <resource-group-name> con il nome del proprio gruppo di risorse.

• Sostituire il valore segnaposto <storage-account-name> con il nome del proprio account di archiviazione.

Abilitare le metriche nelle pagine del sito Web statico

Dopo che le metriche sono state abilitate, le statistiche sul traffico per i file nel contenitore $web vengono riportate nel dashboard delle metriche.

1. Fare clic su Metriche nella sezione Monitoraggio del menu dell'account di archiviazione.

   

   Annotazioni

   I dati delle metriche vengono generati collegandosi a API diverse delle metriche. Il portale visualizza solo i membri dell'API usati in un determinato intervallo di tempo per concentrarsi solo sui membri che restituiscono dati. Per assicurarsi di poter selezionare il membro API necessario, il primo passaggio consiste nell'espandere l'intervallo di tempo.

2. Fare clic sul pulsante intervallo di tempo, scegliere un intervallo di tempo e quindi fare clic su Applica.

   

3. Selezionare Blob nell'elenco a discesa Spazio dei nomi.

   

4. Selezionare quindi la metrica Uscita .

   

5. Selezionare Somma nel selettore Aggregazione .

   

6. Fare clic sul pulsante Aggiungi filtro e scegliere Nome API dal selettore Proprietà .

   

7. Selezionare la casella accanto a GetWebContent nel selettore Valori per popolare il report delle metriche.

   

   Annotazioni

   La casella di controllo GetWebContent viene visualizzata solo se il membro DELL'API è stato usato entro un determinato intervallo di tempo. Il portale visualizza solo i membri dell'API usati in un determinato intervallo di tempo per concentrarsi solo sui membri che restituiscono dati. Se non è possibile trovare un membro API specifico in questo elenco, espandere l'intervallo di tempo.

Passaggi successivi

• Informazioni su come configurare un dominio personalizzato con il sito Web statico. Vedere Eseguire il mapping di un dominio personalizzato a un endpoint di Archiviazione BLOB di Azure.