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

Neste tutorial, você aprenderá a 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:

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

1. 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+).

2. 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

1. Clone o repositório de exemplo:

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

2. Vá para a pasta raiz do repositório:

   cd serviceconnector-webapp-storageblob-dotnet
   

Criar o aplicativo do Serviço de Aplicativo

1. No terminal, verifique se você está na pasta do repositório WebAppStorageMISample que contém o código do aplicativo.

2. 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.

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óximo passo

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