Tutorial: implantar um aplicativo Web conectado ao Armazenamento de Blobs do Azure com o Conector de Serviço

Artigo
11/23/2023

Saiba como acessar o Armazenamento de Blobs do Azure para um aplicativo Web (não um usuário conectado) em execução no Serviço de Aplicativo do Azure usando identidades gerenciadas. Neste tutorial, você usará a CLI do Azure para concluir as seguintes tarefas:

Configurar o ambiente inicial com a CLI do Azure
Criar uma conta de armazenamento e um contêiner do Armazenamento de Blobs do Azure.
Implantar código para o Serviço de Aplicativo do Azure e conectar-se ao armazenamento com identidade gerenciada usando o Conector de Serviço

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.
- Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.
- Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.
- Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

Configurar o seu ambiente inicial

Verifique se sua versão da CLI do Azure é 2.30.0 ou posterior:
```
az --version
```
Se você precisar atualizar, execute o comando (requer a az upgrade versão 2.11+).
Entre no Azure usando a CLI:
```
az login
```
Esse comando abre um navegador para coletar suas credenciais. Quando o comando for concluído, ele mostrará uma saída JSON que contém informações sobre suas assinaturas.

Depois de conectado, você poderá executar os comandos do Azure com a CLI do Azure para trabalhar com recursos na sua assinatura.

Clonar ou baixar o aplicativo de exemplo

Clone o repositório de exemplo:

git clone https://github.com/Azure-Samples/serviceconnector-webapp-storageblob-dotnet.git

Acesse a pasta raiz do repositório:

cd serviceconnector-webapp-storageblob-dotnet

Criar o aplicativo do Serviço de Aplicativo

No terminal, verifique se você está na pasta do repositório WebAppStorageMISample que contém o código do aplicativo.
Crie um aplicativo do Serviço de Aplicativo (o processo do host) com o az webapp up comando abaixo e substitua os espaços reservados por seus próprios dados:
- Para o --location argumento, use uma região com suporte no Service Connector.
- Substitua <app-name> por um nome exclusivo no Azure. O ponto de extremidade do servidor é https://<app-name>.azurewebsites.net. Os caracteres permitidos para <app-name> são A-Z, 0-9 e -. Um bom padrão é usar uma combinação do nome da empresa e um identificador de aplicativo.
```
 az webapp up --name <app-name> --sku B1 --location eastus --resource-group ServiceConnector-tutorial-rg
```

Criar uma conta de armazenamento e um contêiner do Armazenamento de Blobs

No terminal, execute o comando a seguir para criar uma conta de armazenamento de uso geral v2 e um contêiner do Armazenamento de Blobs.

az storage account create --name <storage-name> --resource-group ServiceConnector-tutorial-rg --sku Standard_RAGRS --https-only

Substitua <storage-name> por um nome exclusivo. O nome do contêiner deve estar com letras minúsculas, começar com uma letra ou um número e pode incluir apenas letras, números e o caractere traço (-).

Conectar um aplicativo do Serviço de Aplicativo a um contêiner do Armazenamento de Blobs com uma identidade gerenciada

No terminal, execute o seguinte comando para conectar seu aplicativo Web a um armazenamento de blob usando uma identidade gerenciada.

az webapp connection create storage-blob -g ServiceConnector-tutorial-rg -n <app-name> --tg ServiceConnector-tutorial-rg --account <storage-name> --system-identity

Substitua os seguintes espaços reservados por seus próprios dados:

Substitua pelo <app-name> nome do aplicativo Web usado na etapa 3.
Substitua pelo <storage-name> nome do aplicativo de armazenamento usado na etapa 4.

Observação

Se você vir a mensagem de erro "A assinatura não está registrada para usar Microsoft.ServiceLinker", execute para registrar o provedor de recursos do Service Connector e execute az provider register -n Microsoft.ServiceLinker o comando de conexão novamente.

Executar código de exemplo

No terminal, execute o comando a seguir para abrir o aplicativo de exemplo em seu navegador. Substitua <app-name> pelo nome do aplicativo Web usado anteriormente.

az webapp browse --name <app-name>

O código de exemplo é um aplicativo Web. Cada vez que você atualizar a página de índice, o aplicativo criará ou atualizará um blob com o texto Hello Service Connector! Current is {UTC Time Now} para o contêiner de armazenamento e ele será lido novamente para mostrá-lo na página de índice.

Próximas etapas

Para saber mais sobre o Service Connector, leia o guia abaixo.

Conceitos do Service Connector

Compartilhar via