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

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 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 obter mais informações, 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

1. Verifique se sua versão da CLI do Azure é 2.30.0 ou posterior:

   az --version
   

   Se você precisar atualizar, execute o comando az upgrade (requer a versão 2.11+).

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

1. Clone o repositório de exemplo:

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

2. Acesse 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 az webapp up abaixo e substitua os espaços reservados por seus próprios dados:

   • Para o argumento --location, use uma região compatível com o Conector de Serviço.
   • 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 comando a seguir para conectar seu aplicativo Web a um armazenamento de blobs 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 <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 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óxima etapa

Para saber mais sobre o Conector de Serviço, leia o guia abaixo.