Alojar um site estático no Armazenamento do Azure

Artigo
05/11/2023

Pode servir conteúdo estático (HTML, CSS, JavaScript e ficheiros de imagem) diretamente a partir de um contentor numa conta de fins gerais V2 ou BlockBlobStorage . Para saber mais, veja Alojamento de sites estáticos no Armazenamento do Azure.

Este artigo mostra-lhe como ativar o alojamento de sites estáticos com o portal do Azure, a CLI do Azure ou o PowerShell.

Ativar o alojamento de sites estáticos

O alojamento de sites estáticos é uma funcionalidade que tem de ativar na conta de armazenamento.

Inicie sessão no portal do Azure para começar.
Localize a sua conta de armazenamento e selecione-a para apresentar o painel Descrição Geral da conta.
No painel Descrição Geral , selecione o separador Capacidades . Em seguida, selecione Site estático para apresentar a página de configuração do site estático.
Selecione Ativado para ativar o alojamento de sites estáticos para a conta de armazenamento.
No campo Nome do documento do índice , especifique uma página de índice predefinida (por exemplo: index.html).

A página de índice predefinida é apresentada quando um utilizador navega para a raiz do seu site estático.
No campo Caminho do documento erro , especifique uma página de erro predefinida (por exemplo: 404.html).

A página de erro predefinida é apresentada quando um utilizador tenta navegar para uma página que não existe no seu site estático.
Clique em Guardar para concluir a configuração do site estático.
É apresentada uma mensagem de confirmação. Os pontos finais estáticos do site e outras informações de configuração são apresentados no painel Descrição geral .

Pode ativar o alojamento de sites estáticos com a CLI do Azure.

Em primeiro lugar, abra a Cloud Shell do Azure ou, se tiver instalado a CLI do Azure localmente, abra uma aplicação de consola de comandos, como Windows PowerShell.
Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa para a subscrição da conta de armazenamento que irá alojar o seu site estático.
```
az account set --subscription <subscription-id>
```
Substitua o valor do <subscription-id> marcador de posição pelo ID da sua subscrição.
Ativar o alojamento de sites estáticos.
```
az storage blob service-properties update --account-name <storage-account-name> --static-website --404-document <error-document-name> --index-document <index-document-name>
```
- Substitua o valor do <storage-account-name> marcador de posição pelo nome da sua conta de armazenamento.
- Substitua o <error-document-name> marcador de posição pelo nome do documento de erro que será apresentado aos utilizadores quando um browser pedir uma página no seu site que não exista.
- Substitua o <index-document-name> marcador de posição pelo nome do documento de índice. Normalmente, este documento é "index.html".

Pode ativar o alojamento de sites estáticos com o módulo Azure PowerShell.

Abra uma janela de comando Windows PowerShell.
Verifique se tem Azure PowerShell módulo Az versão 0.7 ou posterior.
```
Get-InstalledModule -Name Az -AllVersions | select Name,Version
```
Se precisar de instalar ou atualizar, veja Install Azure PowerShell module(Instalar o módulo do Azure PowerShell).
Inicie sessão na sua subscrição do Azure com o comando Connect-AzAccount e siga as instruções no ecrã.
```
Connect-AzAccount
```
Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa para a subscrição da conta de armazenamento que irá alojar o seu site estático.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
Substitua o valor do <subscription-id> marcador de posição pelo ID da sua subscrição.
Obtenha o contexto da conta de armazenamento que define a conta de armazenamento que pretende utilizar.
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- Substitua o valor do <resource-group-name> marcador de posição pelo nome do grupo de recursos.
- Substitua o valor do <storage-account-name> marcador de posição pelo nome da sua conta de armazenamento.
Ativar o alojamento de sites estáticos.
```
Enable-AzStorageStaticWebsite -Context $ctx -IndexDocument <index-document-name> -ErrorDocument404Path <error-document-name>
```
- Substitua o <error-document-name> marcador de posição pelo nome do documento de erro que será apresentado aos utilizadores quando um browser pedir uma página no seu site que não exista.
- Substitua o <index-document-name> marcador de posição pelo nome do documento de índice. Normalmente, este documento é "index.html".

Carregar ficheiros

As seguintes instruções mostram-lhe como carregar ficheiros com o portal do Azure. Também pode utilizar o AzCopy, o PowerShell, a CLI ou qualquer aplicação personalizada que possa carregar ficheiros para o contentor $web da sua conta. Para obter um tutorial passo a passo que carrega ficheiros com o Visual Studio Code, veja Tutorial: Alojar um site estático no Armazenamento de Blobs.

Na portal do Azure, navegue para a conta de armazenamento que contém o seu site estático. Selecione Contentores no painel de navegação esquerdo para apresentar a lista de contentores.
No painel Contentores , selecione o contentor $web para abrir o painel Descrição Geral do contentor.
No painel Descrição Geral , selecione o ícone Carregar para abrir o painel Carregar blob . Em seguida, selecione o campo Ficheiros no painel Carregar blob para abrir o browser de ficheiros. Navegue para o ficheiro que pretende carregar, selecione-o e, em seguida, selecione Abrir para preencher o campo Ficheiros . Opcionalmente, selecione a caixa de verificação Substituir se já existirem ficheiros .
Se pretender que o browser apresente o conteúdo do ficheiro, certifique-se de que o tipo de conteúdo desse ficheiro está definido como text/html. Para verificar, selecione o nome do blob que carregou no passo anterior para abrir o painel Descrição Geral . Certifique-se de que o valor está definido no campo de propriedade CONTENT-TYPE .

Nota

Esta propriedade é definida automaticamente como text/html para extensões normalmente reconhecidas, como .html. No entanto, em alguns casos, terá de definir isto manualmente. Se não definir esta propriedade como text/html, o browser pedirá aos utilizadores para transferirem o ficheiro em vez de comporem os conteúdos. Esta propriedade pode ser definida no passo anterior.

Carregue objetos para o contentor $web a partir de um diretório de origem.

Este exemplo pressupõe que está a executar comandos a partir do Azure Cloud Shell sessão.

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

Nota

Se o browser pedir aos utilizadores para transferirem o ficheiro em vez de comporem os conteúdos, pode acrescentar --content-type 'text/html; charset=utf-8' ao comando .

Substitua o valor do <storage-account-name> marcador de posição pelo nome da sua conta de armazenamento.
Substitua o <source-path> marcador de posição por um caminho para a localização dos ficheiros que pretende carregar.

Nota

Se estiver a utilizar uma instalação de localização da CLI do Azure, pode utilizar o caminho para qualquer localização no seu computador local (por exemplo: C:\myFolder.

Se estiver a utilizar o Azure Cloud Shell, terá de referenciar uma partilha de ficheiros que esteja visível para o Cloud Shell. Esta localização pode ser a partilha de ficheiros da própria partilha da Cloud ou uma partilha de ficheiros existente que monta a partir do Cloud Shell. Para saber como fazê-lo, veja Persistir ficheiros no Azure Cloud Shell.

Carregue objetos para o contentor $web a partir de um diretório de origem.

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

Nota

Se o browser pedir aos utilizadores para transferirem o ficheiro em vez de comporem os conteúdos, pode acrescentar -Properties @{ ContentType = "text/html; charset=utf-8";} ao comando .

Substitua o valor do <path-to-file> marcador de posição pelo caminho completamente qualificado para o ficheiro que pretende carregar (por exemplo: C:\temp\index.html).
Substitua o valor do <blob-name> marcador de posição pelo nome que pretende atribuir ao blob resultante (por exemplo: index.html).

Localizar o URL do site

Pode ver as páginas do seu site a partir de um browser através do URL público do site.

No painel que aparece ao lado da página de descrição geral da conta da sua conta de armazenamento, selecione Site Estático. O URL do seu site é apresentado no campo Ponto final primário .

Métrica de métricas de sites estáticos do Armazenamento do Microsoft Azure

Localize o URL público do seu site estático com o seguinte comando:

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

Substitua o valor do <storage-account-name> marcador de posição pelo nome da sua conta de armazenamento.
Substitua o valor do <resource-group-name> marcador de posição pelo nome do grupo de recursos.

Localize o URL público do seu site estático com o seguinte comando:

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

Substitua o valor do <resource-group-name> marcador de posição pelo nome do grupo de recursos.
Substitua o valor do <storage-account-name> marcador de posição pelo nome da sua conta de armazenamento.

Ativar métricas em páginas de sites estáticos

Depois de ativar as métricas, as estatísticas de tráfego nos ficheiros no contentor $web são comunicadas no dashboard de métricas.

Clique em Métricas na secção Monitorizar do menu da conta de armazenamento.

Nota

Os dados de métricas são gerados através da ligação a APIs de métricas diferentes. O portal apresenta apenas os membros da API utilizados num determinado período de tempo para se concentrarem apenas nos membros que devolvem dados. Para garantir que consegue selecionar o membro da API necessário, o primeiro passo é expandir o período de tempo.
Clique no botão de intervalo de tempo, escolha um período de tempo e, em seguida, clique em Aplicar.
Selecione Blob na lista pendente Espaço de Nomes .
Em seguida, selecione a Métrica de saída .
Selecione Soma no seletor de agregação .
Clique no botão Adicionar filtro e selecione Nome da API no Seletor de propriedades .
Selecione a caixa junto a GetWebContent no seletorValores para preencher o relatório de métricas.

Nota

A caixa de verificação GetWebContent só é apresentada se esse membro da API tiver sido utilizado dentro de um determinado período de tempo. O portal apresenta apenas os membros da API utilizados num determinado período de tempo para se concentrarem apenas nos membros que devolvem dados. Se não conseguir encontrar um membro específico da API nesta lista, expanda o período de tempo.