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.

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.

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

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

   

2. Na página Introdução, insira Cache do Azure para Redis na barra de pesquisa. Nos resultados da pesquisa, localize Cache do Azure para Redis e selecione Criar.

   

3. No painel Novo Cache Redis, na guia Básico, defina as seguintes configurações para o cache:

   Configuração	Ação	Descrição
   Assinatura	Selecione sua assinatura do Azure.	A assinatura a ser usada para criar a instância do Cache do Azure para Redis.
   Grupo de recursos	Selecione um grupo de recursos ou selecione Criar novo e insira um novo nome de grupo de recursos.	Um nome para o grupo de recursos em que você criará o cache e outros 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 DNS	Insira um nome exclusivo.	O nome do cache precisa ser uma cadeia de caracteres com 1 a 63 caracteres contendo somente números, letras e hifens. O nome deve 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 é \<DNS name>.redis.cache.windows.net.
   Localidade	Selecione uma localização.	Uma região do Azure que esteja próxima a outros serviços que usam o cache.
   Cache SKU	Selecione um SKU.	O SKU determina os parâmetros de tamanho, desempenho e recurso disponíveis para o cache. Para obter mais informações, consulte Visão geral do Cache do Azure para Redis.
   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 clique em Avançar: rede.

5. Na guia Rede, selecione um método de conectividade a ser usado para o cache.

6. Selecione a guia Avançado ou clique em Avançar: avançado.

7. No painel Avançado, verifique ou selecione um método de autenticação com base nas seguintes informações:

   

   • Por padrão, para um novo cache Básico, Standard ou Premium, a Autenticação do Microsoft Entra está habilitada e a Autenticação de Chaves de Acesso está desabilitada.
   • Para caches Básico ou Standard, é possível escolher a seleção de uma porta não TLS.
   • Para caches Standard e Premium, é possível optar por habilitar zonas de disponibilidade. Não é possível desabilitar zonas de disponibilidade após a criação do cache.
   • Para um cache Premium, defina as configurações para porta não TLS, clustering, identidade gerenciada e persistência de dados.

   Importante

   Para otimizar a segurança, recomendamos usar o Microsoft Entra ID com identidades gerenciadas a fim de autorizar solicitações no cache, se possível. A autorização usando o Microsoft Entra ID e identidades gerenciadas oferece segurança superior e facilidade de uso em relação à autorização de chave de acesso compartilhada. Para saber como usar as identidades gerenciadas com o cache, confira Usar o Microsoft Entra ID para autenticação de cache.

8. (Opcional) Selecione a guia Categorias ou clique em Avançar: categorias.

9. (Opcional) Na guia Categorias, insira um nome e um valor de categoria se você quiser categorizar o recurso de cache.

10. Selecione o botão Revisar + criar.

    Na guia Examinar + criar, o Azure valida a configuração automaticamente.

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

Uma nova implantação de cache ocorre durante diversos minutos. Você pode monitorar o progresso da implantação no painel Visão Geral do Cache do Azure para Redis. Quando o Status mostrar 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.

   

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.

   

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

   

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