Tutorial: Implantar um aplicativo Web conectado ao Armazenamento de Blobs do Azure com o Service Connector

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 seu ambiente inicial com a CLI do Azure
Crie uma conta de armazenamento e um contêiner de Armazenamento de Blob do Azure.
Implantar código no Serviço de Aplicativo do Azure e conectar-se ao armazenamento com identidade gerenciada usando o Service Connector

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.

Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
- Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.
- Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
- Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Configurar seu ambiente inicial

Verifique se a versão da CLI do Azure é 2.30.0 ou superior:
```
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
```
Este comando abre um navegador para reunir suas credenciais. Quando o comando terminar, ele mostra uma saída JSON contendo informações sobre suas assinaturas.

Depois de entrar, você pode executar comandos do Azure com a CLI do Azure para trabalhar com recursos em sua assinatura.

Clone ou baixe o aplicativo de exemplo

Clone o repositório de exemplo:

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

Vá para 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 de host) com o comando abaixo e substitua az webapp up os espaços reservados por seus próprios dados:
- Para o argumento, use uma região suportada --location pelo 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,-09 e .- Um bom padrão é usar uma combinação do nome da sua 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 de Armazenamento de Blob

No terminal, execute o seguinte comando para criar uma conta de armazenamento v2 de uso geral e um contêiner de Armazenamento de Blob.

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 em 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 de Armazenamento de Blob 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 pelos seus próprios dados:

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

Nota

Se vir a mensagem de erro "A subscrição não está registada para utilizar Microsoft.ServiceLinker", execute para registar o fornecedor de recursos do Service Connector e execute az provider register -n Microsoft.ServiceLinker novamente o comando de ligação.

Executar código de exemplo

No terminal, execute o seguinte comando 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ê atualiza a página de índice, o aplicativo cria ou atualiza um blob com o texto Hello Service Connector! Current is {UTC Time Now} para o contêiner de armazenamento e lê novamente para mostrá-lo na página de índice.

Próximos passos

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

Conceitos do Service Connector

Share via