Guia de início rápido: usar a Grade de Eventos do Azure para rotear eventos de armazenamento de Blob para o ponto de extremidade da Web (portal do Azure)

A Grade de Eventos é um serviço totalmente gerenciado que permite gerenciar facilmente eventos em muitos serviços e aplicativos diferentes do Azure. Ele simplifica a criação de aplicativos orientados a eventos e sem servidor. Para obter uma visão geral do serviço, consulte Visão geral da grade de eventos.

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Quando terminar, verá que os dados do evento são enviados para a aplicação Web.

Criar uma conta de armazenamento

1. Inicie sessão no portal do Azure.

2. Para criar um armazenamento de Blobs, selecione Criar um recurso.

3. Na Pesquisa, insira Conta de armazenamento e selecione Conta de armazenamento na lista de resultados.

   

4. Na página Conta de armazenamento, selecione Criar para começar a criar a conta de armazenamento. Para subscrever eventos, tem de criar uma conta de armazenamento de Blobs ou uma conta de armazenamento de fins gerais v2.

5. Na página Criar conta de armazenamento, execute as seguintes etapas:

   1. Selecione a subscrição do Azure.

   2. Para Grupo de recursos, crie um novo grupo de recursos ou selecione um existente.

   3. Introduza o nome da sua conta de armazenamento.

   4. Selecione a região na qual você deseja que a conta de armazenamento seja criada.

   5. Para Serviço principal, selecione Armazenamento de Blobs do Azure ou Azure Data Lake Storage Gen 2.

   6. Em Redundância, selecione Armazenamento com redundância local (LRS) na lista suspensa.

   7. Selecione Rever + criar na parte inferior da página.

      

   8. No separador Rever + criar, reveja as definições e selecione Criar.

      Nota

      Apenas contas de armazenamento do tipo StorageV2 (uso geral v2) e BlobStorage suportam a integração de eventos. O armazenamento (finalidade geral v1) não suporta a integração com a Grade de Eventos.

6. A implantação leva alguns minutos para ser concluída. Na página Implantação, selecione Ir para recurso.

   

7. Na página Conta de armazenamento, selecione Eventos no menu à esquerda.

   

8. Mantenha esta página no navegador da Web aberta.

Criar um ponto final de mensagem

Antes de subscrever aos eventos do armazenamento de Blobs, vamos criar o ponto final para a mensagem de evento. Normalmente, o ponto final executa as ações com base nos dados do evento. Para simplificar esse início rápido, implante um aplicativo Web pré-criado que exibe as mensagens do evento. A solução implementada inclui um plano do Serviço de Aplicações, uma aplicação Web do Serviço de Aplicações e o código de origem do GitHub.

1. Selecione Implementar no Azure para implementar a solução para a sua subscrição.

   

2. Na página Implantação personalizada, execute as seguintes etapas:

   1. Em Grupo de recursos, selecione o grupo de recursos que você criou ao criar a conta de armazenamento. Será mais fácil para você limpar depois de terminar o tutorial, excluindo o grupo de recursos.

   2. Em Nome do Site, insira um nome para o aplicativo Web.

   3. Em Nome do plano de hospedagem, insira um nome para o plano do Serviço de Aplicativo a ser usado para hospedar o aplicativo Web.

   4. Selecione Rever + criar.

      

3. Na página Rever + criar, selecione Criar.

4. A implantação leva alguns minutos para ser concluída. Na página Implantação, selecione Ir para o grupo de recursos.

   

5. Na página Grupo de recursos, na lista de recursos, selecione o aplicativo Web que você criou. Você também vê o plano do Serviço de Aplicativo e a conta de armazenamento nesta lista.

   

6. Na página Serviço de Aplicativo do seu aplicativo Web, selecione a URL para navegar até o site. O URL deve estar neste formato: https://<your-site-name>.azurewebsites.net.

   

7. Confirme que você vê o site, mas nenhum evento foi publicado nele ainda.

   

   Importante

   Mantenha a janela do Visualizador de Grade de Eventos do Azure aberta para que você possa ver os eventos à medida que são publicados.

Subscrever a conta de armazenamento de Blobs

Subscreva um tópico para comunicar ao Event Grid os eventos que pretende controlar e para onde enviar os eventos.

1. Se você fechou a página Conta de armazenamento , navegue até sua conta de Armazenamento do Azure criada anteriormente. No menu à esquerda, selecione Todos os recursos e selecione sua conta de armazenamento.

2. Na página Conta de armazenamento, selecione Eventos no menu à esquerda.

3. Selecione Mais Opções, e Webhook. Você está enviando eventos para seu aplicativo visualizador usando um gancho da Web para o ponto de extremidade.

   

4. Na página Criar Assinatura de Evento , execute as seguintes etapas:

   1. Insira um nome para a assinatura do evento.

   2. Insira um nome para o tópico do sistema. Para saber mais sobre tópicos do sistema, consulte Visão geral dos tópicos do sistema.

   3. Confirme se Tipo de ponto de extremidade está definido como Web Hook.

      

5. Para Ponto de extremidade, selecione Configurar um ponto de extremidade, introduza o URL da sua aplicação Web e adicione api/updates ao URL da página inicial (por exemplo: https://spegridsite.azurewebsites.net/api/updates) e, em seguida, selecione Confirmar seleção.

   

6. Agora, na página Criar Assinatura de Evento , selecione Criar para criar a assinatura do evento.

   

7. Exiba seu aplicativo Web novamente e observe que um evento de validação de assinatura foi enviado para ele. Selecione o ícone do olho para expandir os dados do evento. O Event Grid envia o evento de validação para que o ponto final possa verificar que pretende receber dados de eventos. A aplicação Web inclui código para validar a subscrição.

   

Agora, vamos acionar um evento para ver como o Event Grid distribui a mensagem para o ponto final.

Enviar um evento para o seu ponto final

Aciona um evento para o armazenamento de Blobs ao carregar um ficheiro. O ficheiro não precisa de qualquer conteúdo específico.

1. No portal do Azure, navegue até sua conta de armazenamento de Blob e selecione Contêineres no menu permitir.

2. Selecionar + Contentor. Dê um nome ao contêiner, use qualquer nível de acesso e selecione Criar.

   

3. Selecione o novo contentor.

   

4. Para carregar um ficheiro, selecione Carregar. Na página Carregar blob, procure e selecione um arquivo que você deseja carregar para teste e, em seguida, selecione Carregar nessa página.

   

5. Navegue para o ficheiro de teste e carregue-o.

6. Você disparou o evento e a Grade de Eventos enviou a mensagem para o ponto de extremidade que você configurou ao se inscrever. A mensagem está no formato JSON e contém uma matriz com um ou mais eventos. No exemplo a seguir, a mensagem JSON contém uma matriz com um evento. Exiba seu aplicativo Web e observe que um evento criado por blob foi recebido.

   

Clean up resources (Limpar recursos)

Se quiser continuar a trabalhar com este evento, não limpe os recursos criados neste artigo. Caso contrário, elimine os recursos que criou neste artigo.

Selecione o grupo de recursos e selecione Eliminar grupo de recursos.

Conteúdos relacionados

Agora que sabe como criar tópicos personalizados e subscrições de eventos, saiba mais sobre o que o Event Grid pode ajudá-lo a fazer:

• Encaminhar eventos de armazenamento de Blobs para um ponto final Web personalizado
• Monitorizar alterações de máquina virtual com o Azure Event Grid e Logic Apps
• Transmitir macrodados em fluxo para um armazém de dados