Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Importante
O Cache do Azure para Redis anunciou a linha do tempo de desativação para todos os SKUs. Recomendamos migrar suas instâncias do Cache do Azure para Redis para o Redis Gerenciado pelo Azure assim que possível.
Para obter mais detalhes sobre a aposentadoria:
A Grade de Eventos do Azure é um serviço de eventos para a nuvem. Neste guia de início rápido, você usará o Azure PowerShell para assinar eventos do Azure Cache para Redis, disparar um evento e exibir 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. Quando você concluir as etapas descritas neste guia de início rápido, verá que os dados do evento foram enviados ao aplicativo Web.
Configuração
Este início rápido requer que você esteja executando a versão mais recente do Azure PowerShell. Se você precisa instalar ou atualizar, confira Instalar e configurar o Azure PowerShell.
Entrar no Azure
Entre em sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela para fazer a autenticação.
Connect-AzAccount
Este exemplo usa westus2 e armazena a seleção em uma variável para uso em toda parte.
$location = "westus2"
Criar um grupo de recursos
Os tópicos da Grade de Eventos são implantados como recursos individuais do Azure e precisam ser provisionados em um grupo de recursos do Azure. Um grupo de recursos é uma coleção lógica na qual os recursos do Azure são implantados e gerenciados.
Crie um grupo de recursos com o comando New-AzResourceGroup .
O exemplo a seguir cria um grupo de recursos chamado gridResourceGroup no local westus2.
$resourceGroup = "gridResourceGroup"
New-AzResourceGroup -Name $resourceGroup -Location $location
Criar uma instância de Cache do Azure para Redis
New-AzRedisCache
-ResourceGroupName <String>
-Name <String>
-Location <String>
[-Size <String>]
[-Sku <String>]
[-RedisConfiguration <Hashtable>]
[-EnableNonSslPort <Boolean>]
[-TenantSettings <Hashtable>]
[-ShardCount <Int32>]
[-MinimumTlsVersion <String>]
[-SubnetId <String>]
[-StaticIP <String>]
[-Tag <Hashtable>]
[-Zone <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Para obter mais informações sobre como criar uma instância de cache no PowerShell, consulte a referência do Azure PowerShell.
Criar um ponto de extremidade de mensagem
Antes de assinar o tópico, vamos criar o ponto de extremidade para a mensagem do evento. Normalmente, o ponto de extremidade executa ações com base nos dados de evento. Para simplificar este início rápido, você implanta um aplicativo Web criado previamente que exibe as mensagens de eventos. 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.
Substitua <your-site-name> por um nome exclusivo para o aplicativo Web. O nome do aplicativo Web deve ser exclusivo, pois é parte de uma entrada DNS.
$sitename="<your-site-name>"
New-AzResourceGroupDeployment `
-ResourceGroupName $resourceGroup `
-TemplateUri "https://raw.githubusercontent.com/Azure-Samples/azure-event-grid-viewer/main/azuredeploy.json" `
-siteName $sitename `
-hostingPlanName viewerhost
A implantação pode levar alguns minutos para ser concluída. Depois que a implantação for bem-sucedida, exiba seu aplicativo Web para garantir que ele esteja em execução. Em um navegador da Web, navegue até: https://<your-site-name>.azurewebsites.net
Você deve ver o site sem mensagens exibidas no momento.
Inscreva-se em seu evento do Azure Cache para Redis
Nesta etapa, você assinará um tópico para informar ao Event Grid quais eventos você deseja acompanhar. O exemplo a seguir assina a instância de cache que você criou e passa a URL do seu aplicativo web como o ponto de extremidade para a notificação de evento. O ponto de extremidade para seu aplicativo Web deve incluir o sufixo /api/updates/.
$cacheId = (Get-AzRedisCache -ResourceGroupName $resourceGroup -Name $cacheName).Id
$endpoint="https://$sitename.azurewebsites.net/api/updates"
New-AzEventGridSubscription `
-EventSubscriptionName <event_subscription_name> `
-Endpoint $endpoint `
-ResourceId $cacheId
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.
Disparar um evento do Cache do Azure para Redis
Agora, vamos disparar um evento para ver como a Grade de Eventos distribui a mensagem para o ponto de extremidade.
Import-AzRedisCache
[-ResourceGroupName <String>]
-Name <String>
-Files <String[]>
[-Format <String>]
[-Force]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Para obter mais informações sobre como importar no PowerShell, consulte a referência do Azure PowerShell.
Você disparou o evento, e a Grade de Eventos enviou a mensagem para o ponto de extremidade configurado durante a assinatura. Exiba seu aplicativo Web para ver o evento que você acabou de enviar.
[{
"id": "e1ceb52d-575c-4ce4-8056-115dec723cff",
"eventType": "Microsoft.Cache.ImportRDBCompleted",
"topic": "/subscriptions/{subscription_id}/resourceGroups/{resource_group_name}/providers/Microsoft.Cache/Redis/{cache_name}",
"data": {
"name": "ImportRDBCompleted",
"timestamp": "2020-12-10T18:07:54.4937063+00:00",
"status": "Succeeded"
},
"subject": "ImportRDBCompleted",
"dataversion": "1.0",
"metadataVersion": "1",
"eventTime": "2020-12-10T18:07:54.4937063+00:00"
}]
Limpar os recursos
Se você pretende continuar trabalhando com essa instância do Cache do Azure para Redis e a assinatura de evento, não limpe os recursos criados neste guia de início rápido. Se você não planeja continuar, use o comando a seguir para excluir os recursos criados neste início rápido.
Remove-AzResourceGroup -Name $resourceGroup
Próximas etapas
Agora que você sabe como criar tópicos e assinaturas de eventos, saiba mais sobre os eventos do Cache do Azure para Redis e o que a Grade de Eventos pode ajudá-lo a fazer: