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

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.

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

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

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

1. No portal do Azure, pesquise e selecione o Cache do Azure para Redis.

2. Na página Cache do Azure para Redis , selecione Criar>Cache do Azure para Redis.

3. Na guia Noções básicas da página Novo Cache Redis , defina as seguintes configurações:

   • Assinatura: selecione a assinatura a ser utilizada.
   • Grupo de recursos: selecione um grupo de recursos ou selecione Criar novo e insira um novo nome de grupo de recursos. Colocar todos os recursos do aplicativo no mesmo grupo de recursos permite que você os gerencie ou exclua facilmente.
   • Nome: insira um nome de cache exclusivo na região. O nome deve:
     • Seja uma cadeia de caracteres de 1 a 63 caracteres.
     • Contêm apenas números, letras e hifens.
     • Inicie e termine com um número ou uma letra.
     • Não deve conter hifens consecutivos.
   • Região: selecione uma região do Azure perto de outros serviços que usam seu cache.
   • SKU de cache: selecione um SKU para determinar os tamanhos, o desempenho e os recursos disponíveis para o cache.
   • Tamanho do cache: selecione um tamanho de cache. Para obter mais informações, consulte Visão geral do Cache do Azure para Redis.

   

4. Selecione a guia Rede ou selecione Avançar: Rede.

5. Na guia Rede, selecione um método de conectividade a ser usado para o cache. O Ponto de Extremidade Privado é recomendado para segurança. Se você selecionar Ponto de Extremidade Privado, selecione Adicionar ponto de extremidade privado e crie o ponto de extremidade privado.

6. Selecione a guia Avançado ou selecione Avançar: Avançado.

7. No painel Avançado , configure as seguintes opções:

   • Selecione Autenticação do Microsoft Entra ou Autenticação por Chaves de Acesso. A Autenticação do Microsoft Entra está habilitada por padrão.
   • Escolha se deseja habilitar a porta não TLS.
   • Para um cache Premium, você pode configurar ou desabilitar zonas de disponibilidade. Não é possível desabilitar zonas de disponibilidade após a criação do cache. Para um cache Standard, as zonas de disponibilidade são alocadas automaticamente. As zonas de disponibilidade não estão disponíveis para o SKU Básico.
   • Para um cache Premium, defina as configurações para contagem de réplicas, clustering e contagem de fragmentos, identidade gerenciada atribuída pelo sistema e persistência de dados.

   A imagem a seguir mostra a guia Avançado para o SKU Standard.

   

   Importante

   Use o Microsoft Entra ID com identidades gerenciadas para autorizar solicitações no cache, se possível. A autorização usando a ID do Microsoft Entra e a identidade gerenciada fornece melhor segurança e é mais fácil de usar do que a autorização de chave de acesso compartilhado. Para saber como usar as identidades gerenciadas com o cache, confira Usar o Microsoft Entra ID para autenticação de cache.

8. Opcionalmente, selecione a guia Marcas ou selecione Avançar: Marcas e insira nomes e valores de marca para categorizar os recursos de cache.

9. Selecione Examinar + criar e, depois que a validação for aprovada, selecione Criar.

A nova implantação de cache leva vários minutos. Você pode monitorar o progresso da implantação na página portal do Cache do Azure para Redis. Quando o status do cache é exibido em execução, o cache está pronto para ser usado.

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.

   

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

   1. Em Grupo de recursos, selecione o grupo de recursos que você gerou 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.

   

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.

   

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.

   

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.

   

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

   Configuração	Valor sugerido	Descrição
   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.

   

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.

   

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:

• Como responder aos eventos do Cache do Azure para Redis
• Sobre a Grade de Eventos