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

O Azure Event Grid é um serviço de eventos para a cloud. Neste início rápido, você usará o portal do Azure para criar um Cache do Azure para instância Redis, assinar eventos para essa instância, acionar um evento e exibir os resultados. Normalmente, envia eventos para um ponto final que processa os dados de eventos e efetua ações. No entanto, para simplificar esse início rápido, você enviará eventos para um aplicativo Web que coletará e exibirá as mensagens.

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

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

Criar uma instância de cache do Azure para Redis

1. No portal do Azure, procure e selecione 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:

   • Subscrição: selecione a subscrição que pretende utilizar.
   • 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 seu aplicativo no mesmo grupo de recursos permite que você os gerencie ou exclua facilmente juntos.
   • Nome: insira um nome de cache exclusivo na região. O nome deve:
     • Ser uma sequência de 1 a 63 caracteres.
     • Contêm apenas números, letras e hífenes.
     • Comece e termine com um número ou letra.
     • Não conter hífenes consecutivas.
   • Região: selecione uma região do Azure perto de outros serviços que usam seu cache.
   • SKU de cache: selecione uma SKU para determinar os tamanhos, o desempenho e os recursos disponíveis para seu 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. Private Endpoint é 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 de Chaves de Acesso. A Autenticação do Microsoft Entra está habilitada por padrão.
   • Escolha se deseja Ativar a porta não-TLS.
   • Para um cache Premium, você pode configurar ou desabilitar zonas de disponibilidade. Não é possível desativar as zonas de disponibilidade após a criação do cache. Para um cache padrão, as zonas de disponibilidade são alocadas automaticamente. As zonas de disponibilidade não estão disponíveis para o Basic SKU.
   • Para um cache Premium, defina as configurações para contagem de réplicas, contagem de clusters e estilhaços, identidade gerenciada atribuída ao sistema e persistência de dados.

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

   

   Importante

   Use o Microsoft Entra ID com identidades gerenciadas para autorizar solicitações em seu cache, se possível. A autorização usando o 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 compartilhada. Para obter mais informações sobre como usar identidades gerenciadas com seu cache, consulte Usar a ID do Microsoft Entra para autenticação de cache.

8. Opcionalmente, selecione a guia Tags ou selecione Next: Tags, e insira nomes e valores de tags para categorizar seus recursos de cache.

9. Selecione Rever + criar e, quando 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 Cache do Azure para Redis do portal. Quando o status do cache é exibido em execução, o cache está pronto para uso.

Criar um ponto final de mensagem

Antes de assinar os eventos para a instância de cache, vamos criar o endpoint 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, você implantará 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 Implantar no Azure no README do GitHub para implantar a solução na sua subscrição.

   

2. Na página Implantação personalizada, siga os seguintes passos:

   1. Em Grupo de recursos, selecione o grupo de recursos que você criou ao criar a instância de cache. 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. Marque a caixa de seleção Concordo com os termos e condições mencionados acima.
   5. Selecione Comprar.

   Configuração	Valor sugerido	Descrição
   Subscrição	Drop-down e selecione sua assinatura.	A subscrição na qual pretende criar esta aplicação Web.
   Grupo de recursos	Drop-down e selecione um grupo de recursos, ou selecione Criar novo e insira um novo nome de grupo de recursos.	Ao colocar todos os recursos do seu aplicativo em um grupo de recursos, você pode facilmente gerenciá-los ou excluí-los juntos.
   Nome do Site	Introduza um nome para a sua aplicação 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 nesta lista.

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

6. Confirme que consegue ver o site, mas que ainda não foram publicados eventos no mesmo.

   

Registar o provedor de recursos do Event Grid

A menos que você já tenha usado a Grade de Eventos antes, precisará registrar o provedor de recursos da Grade de Eventos. Se já utilizou a Grelha de Eventos antes, avance para a secção seguinte.

No portal do Azure, execute as seguintes etapas:

1. No menu à esquerda, selecione Assinaturas.

2. Selecione a subscrição que pretende utilizar para a Grelha de Eventos na lista de subscrições.

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

4. Procure Microsoft.EventGrid e confirme se o Status não está registrado.

5. Selecione Microsoft.EventGrid na lista de provedores.

6. Selecione Registrar na barra de comandos.

   

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

   

Inscrever-se na instância do Cache do Azure para Redis

Nesta etapa, você se inscreverá em um tópico para informar à Grade de Eventos quais eventos deseja acompanhar e para onde enviá-los.

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 Web Hook. Você está enviando eventos para o seu aplicativo visualizador usando um webhook para o ponto de extremidade.

   

4. Na página Criar Subscrição de Eventos, insira o seguinte:

   Configuração	Valor sugerido	Descrição
   Nome	Insira um nome para a assinatura do evento.	O valor deve ter entre 3 e 64 caracteres. Pode apenas conter letras, números e traços.
   Tipos de Eventos	Faça uma lista suspensa e selecione o(s) tipo(s) de evento que você deseja enviar para o seu destino. Para este início rápido, dimensionaremos nossa instância de cache.	Patching, escalonamento, importação e exportação são as opções disponíveis.
   Tipo de ponto final	Selecione Web Hook.	Manipulador de eventos para receber seus eventos.
   Ponto final	Selecione Selecionar 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://cache.azurewebsites.net/api/updates) e, em seguida, selecione Confirmar Seleção.	Este é o URL da sua aplicação Web que criou anteriormente.

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

6. Verifique a aplicação Web novamente e repare que um evento de validação de subscrição foi enviado para a mesma. 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.

   

Enviar um evento para o seu ponto final

Agora, vamos acionar um evento para ver como o Event Grid distribui a mensagem para o ponto final. Ampliaremos a instância do seu Cache do Azure para Redis.

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

2. Selecione o nível de preço desejado na página Escala e selecione Selecionar.

   Você pode dimensionar para um nível de preço diferente com as seguintes restrições:

   • Não é possível escalar de um nível de preço mais alto para um nível de preço mais baixo.
     • Não é possível dimensionar de um cache Premium para um cache Standard ou Basic.
     • Não é possível dimensionar de um cache padrão para um cache básico .
   • Você pode dimensionar de um cache Básico para um cache Padrão , mas não pode alterar o tamanho ao mesmo tempo. Se você precisar de um tamanho diferente, poderá fazer uma operação de dimensionamento subsequente para o tamanho desejado.
   • Não é possível dimensionar de um cache Básico diretamente para um cache Premium . Primeiro, dimensione de Basic para Standard em uma operação de dimensionamento e, em seguida, de Standard para 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 está a ser redimensionado para o novo nível de preços, um estado de Dimensionamento é exibido usando Azure Cache for Redis à esquerda. Quando o dimensionamento estiver concluído, o status mudará de Dimensionamento para Execução.

3. Acionou o evento e o Event Grid enviou a mensagem para o ponto final que configurou ao subscrever. 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 ScalingCompleted foi recebido.

   

Limpar recursos

Se planeia continuar a trabalhar com este evento, não limpe os recursos criados neste início rápido. Caso contrário, exclua os recursos criados neste início rápido.

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

Próximos passos

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:

• Reagir a eventos do Azure Cache para Redis
• Sobre o Event Grid