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 eventos facilmente em vários serviços e aplicativos diferentes do Azure. Ela simplifica a criação de aplicativos orientados a eventos e sem servidor. Para uma visão geral do serviço, consulte Visão geral da Grade de Eventos.

Neste artigo, você usa o portal do Azure para fazer as seguintes tarefas:

1. Criar uma conta de armazenamento de Blobs.
2. Assinar eventos para esse armazenamento de blob.
3. Disparar um evento carregando um arquivo no armazenamento de Blobs.
4. Exibir o resultado em um aplicativo Web manipulador. Normalmente, você envia eventos para um ponto de extremidade que processa os dados de evento e realiza ações. Para simplificar, você enviará eventos para um aplicativo Web que coleta e exibe as mensagens.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Ao concluir, você verá que os dados do evento foram enviados para um aplicativo Web.

Criar uma conta de armazenamento

1. Entre no Portal do Azure.

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

3. Em Pesquisar, insira Conta de armazenamentoe 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 assinar eventos, crie uma conta de armazenamento v2 para uso geral ou uma conta de armazenamento de blobs.

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

   1. Selecione sua assinatura do Azure.

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

   3. Insira o nome para a conta de armazenamento.

   4. Selecione a Região na qual deseja que a conta de armazenamento seja criada.

   5. Para Redundância, selecione LRS (armazenamento com redundância local) na lista suspensa.

   6. Selecione Revisão na parte inferior da página.

      

   7. Na página de Revisão, examine as configurações e selecione Criar.

      Observação

      Somente contas de armazenamento do tipo StorageV2 (v2 de uso geral) e BlobStorage dão suporte à integração de eventos. O armazenamento (v1 de uso geral)não dá suporte à integração da Grade de Eventos.

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

   

7. Na página da Conta de armazenamento, selecione Eventos no menu esquerdo.

   

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

Criar um ponto de extremidade de mensagem

Antes de assinar eventos para o armazenamento de Blobs, vamos criar o ponto de extremidade para mensagens de evento. Normalmente, o ponto de extremidade executa ações com base nos dados de evento. Para simplificar esse início rápido, implante um aplicativo web predefinido que exiba as mensagens do evento. A solução implantada inclui um plano do Serviço de Aplicativo, um aplicativo Web do Aplicativo do Serviço de e o código-fonte do GitHub.

1. Selecione Implantar no Azure para implantar a solução na sua assinatura.

   

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

   1. Para Grupo de recursos, selecione o mesmo grupo de recursos que você usou ao criar a conta de armazenamento. Será mais fácil limpar após concluir 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 usar para hospedar o aplicativo Web.

   4. Selecione Examinar + criar.

      

3. Na página Examinar + criar escolha 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 verá o plano do Serviço de Aplicativo e a conta de armazenamento nesta lista.

   

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

   

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

   

   Importante

   Mantenha a janela Visualizador de Eventos da Grade de Eventos do Azure aberta para ver os eventos conforme eles são postados.

Registrar o provedor de recursos da Grade de Eventos

A menos que você tenha usado a Grade de Eventos antes, precisará registrar o provedor de recursos da Grade de Eventos. Se você tiver usado a Grade de Eventos antes, pule para a próxima seção.

No portal do Azure, siga as etapas abaixo:

1. No menu à esquerda, selecione Assinaturas.

2. Selecione a assinatura que você deseja usar para a Grade de Eventos na lista de assinaturas.

3. Na página Assinatura, selecione Provedores de recursos na seção Configurações no menu à esquerda.

4. Pesquise por Microsoft.EventGrid e confirme que o Status é Não registrado.

5. Selecione Microsoft.EventGrid na lista de provedores.

6. Selecione Registrar na barra de comandos.

   

7. Atualize para verificar se o status do Microsoft.EventGrid foi alterado para Registrado.

   

Inscreva-se no armazenamento de Blobs

Assine um tópico para indicar à Grade de Eventos quais eventos você deseja acompanhar e para onde enviar os eventos.

1. Se você fechou a página Conta de armazenamento, navegue até a conta de Armazenamento do Microsoft Azure que você criou anteriormente. No menu esquerdo, selecione Todos os recursos e, em seguida, selecione sua conta de armazenamento.

2. Na página da Conta de armazenamento, selecione Eventos no menu esquerdo.

3. Selecione Mais opções e Web Hook. Você está enviando eventos ao aplicativo visualizador usando um web hook para o ponto de extremidade.

   

4. Na página Criar Assinatura de Eventos, faça o seguinte:

   1. Insira um nome para a assinatura de evento.

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

      

   3. Selecione Web Hook para o Tipo de ponto de extremidade.

      

5. Para Ponto de extremidade, escolha Selecionar um ponto de extremidade, insira a URL do aplicativo Web, adicione api/updates à 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 de evento.

   

7. Exiba novamente o seu aplicativo Web e observe que um evento de validação de assinatura foi enviado a ele. Selecione o ícone de olho para expandir os dados de evento. A Grade de Eventos envia o evento de validação de modo que o ponto de extremidade possa verificar se ele deseja receber os dados de evento. O aplicativo Web inclui o código para validar a assinatura.

   

Agora, vamos disparar um evento para ver como a Grade de Eventos distribui a mensagem para o ponto de extremidade.

Enviar um evento para o ponto de extremidade

Você pode disparar um evento para o armazenamento de Blobs carregando um arquivo. O arquivo não precisa de um conteúdo específico.

1. No portal do Azure, navegue até a conta do Armazenamento de Blobs e selecione Contêineres no menu à esquerda.

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

   

3. Selecione o novo contêiner.

   

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

   

5. Navegue até seu arquivo de teste e carregue-o.

6. Você disparou o evento, e a Grade de Eventos enviou a mensagem para o ponto de extremidade configurado durante a assinatura. 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. Veja seu aplicativo Web e observe que um evento criado por blob foi recebido.

   

Limpar os recursos

Caso planeje continuar a trabalhar com esse evento, não limpe os recursos criados neste artigo. Caso contrário, exclua os recursos criados neste artigo.

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

Próximas etapas

Agora que você sabe como criar tópicos e assinaturas de evento personalizados, saiba mais sobre como a Grade de Eventos pode ajudá-lo:

• Sobre a Grade de Eventos
• Rotear eventos do Armazenamento de Blobs para um ponto de extremidade da Web personalizado
• Monitorar alterações de máquina virtual com a Grade de Eventos do Azure e os Aplicativos Lógicos
• Transmitir Big Data para um data warehouse