Início rápido: Encaminhar eventos do Cache do Azure para Redis para o ponto de extremidade da Web com o portal do Azure

  • Artigo

A Grade de Eventos do Azure é um serviço de eventos para a nuvem. Neste guia de início rápido, você usará o portal do Azure para criar uma instância do Cache do Azure para Redis, assinar eventos dessa instância, disparar um evento e ver os resultados. Normalmente, você envia eventos para um ponto de extremidade que processa os dados de evento e realiza ações. No entanto, para simplificar este guia de início rápido, você enviará eventos para um aplicativo Web que coletará e exibirá as mensagens.

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

Quando terminar, você verá que os dados do evento foram enviados para o aplicativo Web.

Azure Event Grid Viewer scaling in JSON format.

Criar uma instância de cache do Cache do Azure para Redis

  1. Para criar um cache, entre no portal do Azure e selecione Criar um recurso.

    Create a resource is highlighted in the left navigation pane.

  2. Na página Novo, selecione Bancos de dados e, em seguida, Cache do Azure para Redis.

    On New, Databases is highlighted, and Azure Cache for Redis is highlighted.

  3. Na página Novo Cache Redis, defina as configurações para o novo cache.

    Configuração Escolher um valor Descrição
    Assinatura Clique na lista suspensa e selecione sua assinatura. A assinatura na qual essa nova instância do Cache do Azure para Redis será criada.
    Grupo de recursos Clique na lista suspensa e selecione um grupo de recursos ou selecione Criar e insira um novo nome de grupo de recursos. Nome do grupo de recursos no qual o cache e outros recursos serão criados. Ao colocar todos os seus recursos de aplicativos em um só grupo de recursos, você pode gerenciá-los ou excluí-los juntos com facilidade.
    Nome DNS Insira um nome exclusivo. O nome do cache deve conter de 1 a 63 caracteres e incluir somente números, letras ou hifens. O nome precisa começar e terminar com um número ou uma letra e não pode conter hifens consecutivos. O nome do host da instância de cache será <nome DNS>.redis.cache.windows.net.
    Localidade Clique na lista suspensa e selecione uma localização. Selecione uma região perto de outros serviços que usam o seu cache.
    Tipo de cache Clique na lista suspensa e selecione uma camada. A camada determina o tamanho, o desempenho e os recursos disponíveis para o cache. Para obter mais informações, confira Visão geral do Cache do Azure para Redis.

  4. Selecione a guia Rede ou o botão Rede na parte inferior da página.

  5. Na guia Rede, escolha o método de conectividade.

  6. Selecione a guia Próximo: Avançado ou o botão Próximo: Avançado na parte inferior da página para ver a guia Avançado.

    Screenshot showing the Advanced tab in the working pane and the available option to select.

    • Para caches Básico ou Standard, alterne a seleção para uma porta não TLS. Você também pode selecionar se deseja habilitar a Autenticação do Microsoft Entra.
    • Para um cache Premium, defina as configurações para porta não TLS, clustering, identidade gerenciada e persistência de dados. Você também pode selecionar se deseja habilitar a Autenticação do Microsoft Entra.

  7. Selecione a guia Próximo: Marcas ou o botão Próximo: Marcas na parte inferior da página.

  8. Opcionalmente, na guia Marcas, insira o nome e o valor caso deseje categorizar o recurso.

  9. Selecione Examinar + criar. Você será levado para a guia Examinar + criar, na qual o Azure valida sua configuração.

  10. Depois que a mensagem em verde Validação aprovada for exibida, selecione Criar.

A criação do cache demora um pouco. Monitore o progresso na página Visão Geral do Cache do Azure para Redis. Quando o Status for mostrado como Em execução, o cache estará pronto para uso.

Criar um ponto de extremidade de mensagem

Antes de assinar eventos para a instância de cache, vamos criar o ponto de extremidade para a mensagem de evento. Normalmente, o ponto de extremidade executa ações com base nos dados de evento. Para simplificar este guia de início rápido, você implantará um aplicativo Web predefinido que exibe as mensagens de 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 no README do GitHub para implantar a solução na sua assinatura.

    Deploy to Azure button.

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

    1. Em Grupo de recursos, selecione o grupo de recursos que você criou ao criar a instância de cache. 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 a caixa de seleção Concordo com os termos e condições declarados acima.
    5. Selecione Comprar.
    Configuração Valor sugerido Descrição
    Assinatura Clique na lista suspensa e selecione sua assinatura. A assinatura na qual você deseja criar este aplicativo Web.
    Grupo de recursos Clique na lista suspensa e selecione um grupo de recursos ou selecione Criar e insira um novo nome de grupo de recursos. Ao colocar todos os seus recursos de aplicativos em um só grupo de recursos, você pode gerenciá-los ou excluí-los juntos com facilidade.
    Nome do Site Insira um nome para o aplicativo Web. Esse valor não pode estar vazio.
    Nome do plano de hospedagem Insira um nome para o Plano do Serviço de Aplicativo a ser usado para hospedar o aplicativo Web. Esse valor não pode estar vazio.

  3. Selecione alertas (ícone de sino) no portal e, em seguida, selecione Ir para o grupo de recursos.

    Azure portal deployment notification.

  4. 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 instância de cache nessa lista.

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

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

    Empty Event Grid Viewer site.

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.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

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

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Assinar a instância do Cache do Azure para Redis

Nesta etapa, você assinará um tópico para indicar à Grade de Eventos quais eventos deseja acompanhar e para o local em que os eventos serão enviados.

  1. No portal, navegue até a instância de cache criada anteriormente.

  2. Na página Cache do Azure para Redis, selecione Eventos no menu à esquerda.

  3. Selecione Webhook. Você está enviando eventos ao aplicativo visualizador usando um web hook para o ponto de extremidade.

    Azure portal Events page.

  4. Na página Criar Assinatura de Eventos, insira o seguinte:

    Configuração Valor sugerido Description
    Nome Insira um nome para a assinatura de evento. O valor precisa ter entre 3 e 64 caracteres. Ele só pode conter letras, números e traços.
    Tipos de Eventos Escolha o menu suspenso e selecione quais tipos de eventos deseja enviar por push ao destino. Para este guia de início rápido, dimensionaremos nossa instância de cache. Aplicação de patch, dimensionamento, importação e exportação são as opções disponíveis.
    Tipo de Ponto de Extremidade Selecione Webhook. Manipulador de eventos para receber seus eventos.
    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://cache.azurewebsites.net/api/updates) e escolha Confirmar Seleção. Essa é a URL do aplicativo Web que você criou anteriormente.

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

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

    Azure Event Grid Viewer.

Enviar um evento para o ponto de extremidade

Agora, vamos disparar um evento para ver como a Grade de Eventos distribui a mensagem para o ponto de extremidade. Dimensionaremos sua instância do Cache do Azure para Redis.

  1. No portal do Azure, navegue até a instância do Cache do Azure para Redis e selecione Escala no menu à esquerda.

  2. Escolha o tipo de preço desejado na página Escala e escolha Selecionar.

    Você pode dimensionar para um tipo de preço diferente com as restrições a seguir:

    • Você não pode dimensionar de uma camada de preços mais alta para uma camada de preços mais baixa.
      • Você não pode dimensionar de um cache Premium para um cache Standard ou Básico.
      • Você não pode dimensionar de um cache Standard para um cache Básico.
    • É possível dimensionar de um cache Básico para um cache Standard, mas não é possível alterar o tamanho simultaneamente. Se precisar de um tamanho diferente, você pode fazer uma operação de dimensionamento subsequente para o tamanho desejado.
    • Você não pode dimensionar de um cache Básico diretamente para um cache Premium. Você deve dimensionar do Básico para o Standard em uma única operação de dimensionamento e do Standard para o Premium em uma operação de dimensionamento subsequente.
    • Não é possível dimensionar de um tamanho maior para o tamanho C0 (250 MB) .

    Enquanto o cache é dimensionado para a nova camada de preços, é exibido um status Dimensionando no Cache Redis do Azure à esquerda. Quando o dimensionamento for concluído, o status será alterado de Dimensionando para Executando.

  3. 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 ScalingCompleted foi recebido.

    Azure Event Grid Viewer scaling in JSON format.

Limpar os recursos

Caso planeje continuar trabalhando com esse evento, não limpe os recursos criados neste guia de início rápido. Caso contrário, exclua os recursos criados neste guia de início rápido.

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: