Como enviar eventos da Grade de Eventos básicos para os tópicos do namespace da Grade de Eventos

Este artigo descreve como encaminhar os eventos das assinaturas de eventos criadas em recursos como tópicos, tópicos do sistema, domínios e tópicos de parceiro para os namespaces da Grade de Eventos.

Visão geral

A Grade de Eventos básica dá suporte ao tópico Namespace da Grade de Eventos como o tipo de ponto de extremidade. Ao criar uma assinatura de evento para um tópico, tópico do sistema, domínio ou tópico de parceiro da Grade de Eventos, você pode selecionar um tópico de namespace da Grade de Eventos como o ponto de extremidade para lidar com os eventos.

Imagem que mostra os eventos encaminhados do tópico básico da Grade de Eventos para o namespace da Grade de Eventos.

Ter um tópico de namespace como destino em assinaturas de eventos da Grade de Eventos básica ajuda você a fazer a transição para os namespaces da Grade de Eventos sem modificar seu fluxo de trabalho existente. Os namespaces da Grade de Eventos fornecem funcionalidades novas e interessantes que você pode ter interesse em usar nas suas soluções. Se você estiver usando os recursos básicos da Grade de Eventos, como tópicos, tópicos do sistema, domínios e tópicos de parceiros, você só precisa criar uma nova assinatura de evento em seu tópico atual e selecionar o tópico do namespace da Grade de Eventos como destino do manipulador.

Este artigo aborda um exemplo de cenário no qual você encaminha eventos do Armazenamento do Microsoft Azure para um namespace da Grade de Eventos. Aqui estão as etapas de alto nível:

  1. Crie um tópico do sistema para a conta de armazenamento do Azure e habilite a identidade gerenciada para o tópico do sistema.
  2. Atribua a identidade gerenciada do tópico do sistema à função de Remetente de Dados da Grade de Eventos no namespace da Grade de Eventos de destino.
  3. Crie uma assinatura de evento para o tópico do sistema tendo o namespace da Grade de Eventos como o manipulador de eventos e use a identidade gerenciada para a entrega de eventos.

Pré-requisitos

  1. Crie um recurso de namespace da Grade de Eventos seguindo as instruções do artigo Criar, exibir e gerenciar namespaces.
  2. Crie um tópico de namespace da Grade de Eventos seguindo as instruções do artigo Criar, exibir e gerenciar tópicos de namespace.
  3. Crie uma assinatura de evento da Grade de Eventos em um tópico do namespace seguindo as instruções do artigo Criar, exibir e gerenciar assinaturas de eventos em tópicos do namespace. Essa etapa é opcional, mas é útil para testar o cenário.
  4. Crie uma conta de armazenamento do Azure seguindo as instruções do artigo Criar uma conta de armazenamento.

Criar um tópico do sistema e habilitar a identidade gerenciada para a conta de armazenamento

Se você tiver um tópico do sistema existente para a conta de armazenamento, navegue até a página de tópicos do sistema. Se não tiver, crie um tópico do sistema. Em seguida, habilite a identidade gerenciada para a conta de armazenamento.

  1. Navegue até o portal do Azure.

  2. Na barra de pesquisa, pesquise Tópicos do Sistema da Grade de Eventos e os selecione nos resultados da pesquisa.

  3. Na página Tópicos do Sistema da Grade de Eventos, selecione + Criar.

    Captura de tela mostrando a página Tópicos do Sistema com o botão Criar selecionado.

  4. Na página Criar Tópico do Sistema da Grade de Eventos, siga essas etapas:

    1. Para Tipos de Tópico, selecione Contas de Armazenamento.

    2. Para Assinatura, selecione a assinatura do Azure na qual você quer criar o tópico do sistema.

    3. Para Grupo de Recursos, selecione o grupo de recursos para o tópico do sistema.

    4. Para Recurso, selecione o recurso de armazenamento do Azure para o qual você quer criar o tópico do sistema.

    5. Na seção Detalhes do Tópico do Sistema, para Nome, insira um nome para o tópico.

    6. Selecione Revisar + criar na parte inferior da página.

      Captura de tela mostrando a página Criar Tópico do Sistema da Grade de Eventos.

  5. Na páginaRevisar + criar,revise as configurações e selecioneCriar.

    Captura de tela mostrando a página Criar Tópico do Sistema da Grade de Eventos — rever e criar.

  6. Após a implantação ter sido bem-sucedida, selecione Ir para o recurso para ver a página Tópico do Sistema da Grade de Eventos do tópico do sistema que você criou.

Habilitar a identidade gerenciada para o tópico do sistema

Agora, habilite a identidade gerenciada para o tópico do sistema que você criou. Para esse exemplo, vamos criar uma identidade gerenciada atribuída pelo sistema para o tópico do sistema.

  1. Na página Tópico do Sistema da Grade de Eventos, selecione Identidade em Configurações no menu de navegação do lado esquerdo.

  2. Na página Identidade, selecione Ativado para Status.

  3. Selecione Salvar na barra de comandos.

    Captura de tela mostrando a página Identidade do tópico do sistema.

  4. Na janela pop-up de confirmação, selecione Sim para confirmar a criação da identidade gerenciada.

  5. Após a identidade gerenciada ser criada, você verá a ID do objeto (entidade de segurança) para a identidade.

    Mantenha a página Tópico do Sistema aberta na guia atual do seu navegador da web.

Conceder a permissão de identidade para enviar eventos para o namespace

Na última etapa, você criou uma identidade gerenciada atribuída pelo sistema para o tópico do sistema da sua conta de armazenamento. Nessa etapa, você vai conceder à identidade a permissão para enviar eventos para o destino ou o namespace de destino.

  1. Abra uma nova guia ou uma janela do navegador da web. Navegue até o namespace da sua Grade de Eventos no portal do Azure.

  2. Selecione Controle de acesso (IAM) no menu à esquerda.

  3. Selecione Adicionar e selecione Adicionar atribuição de função.

    Captura de tela mostrando a página Controle de Acesso para o namespace da Grade de Eventos.

  4. Na página Função, pesquise e selecione a função Remetente de Dados da Grade de Eventos e, a seguir, selecione Avançar.

    Captura de tela mostrando a página Controle de Acesso com a função Remetente de Dados da Grade de Eventos selecionada.

  5. Na página Membros, para Atribuir acesso a, selecione Identidade gerenciada e, a seguir, selecione + Selecionar membros.

    Captura de tela mostrando a página Membros.

  6. Na página Selecionar identidades gerenciadas, siga estas etapas:

    1. Para Assinatura, selecione a assinatura do Azure em que a identidade gerenciada é criada.

    2. Para Identidade gerenciada, selecione Tópico do Sistema da Grade de Eventos.

    3. Para Selecionar, digite o nome do seu tópico do sistema.

    4. Nos resultados da pesquisa, selecione a identidade gerenciada. O nome da identidade gerenciada é o mesmo que o nome do tópico do sistema.

      Captura de tela mostrando a seleção de uma identidade gerenciada.

  7. Na página Membros, selecione Avançar.

  8. Na página Revisar + atribuir, revise as configurações e selecione Revisar + atribuir na parte inferior da página.

Crie uma assinatura de evento para o tópico do sistema de armazenamento

Agora, você está pronto para criar uma assinatura de evento para o tópico do sistema para a conta de armazenamento de origem usando o namespace como um ponto de extremidade.

  1. Na página Tópico do Sistema para o tópico do sistema, selecione Visão geral no menu do lado esquerdo, se ainda não estiver selecionada.

  2. Selecione +Assinatura de Evento na barra de comando.

    Captura de tela mostrando a página Tópico do Sistema da Grade de Eventos com o botão Assinatura de Evento selecionado.

  3. Na página Criar Assinatura de Eventos, siga estas etapas:

    1. Para Nome, insira o nome de uma assinatura de evento.

    2. Em Esquema de Eventos, selecione o esquema de eventos como Esquema de Eventos de Nuvem v1.0. É o único tipo de esquema compatível com o destino do tópico do namespace da Grade de Eventos.

    3. Para Filtrar para Tipos de Eventos, selecione os tipos de eventos que você quer assinar.

    4. Para Tipo de ponto de extremidade, selecione Tópico do Namespace da Grade de Eventos.

    5. Selecione Configurar um ponto de extremidade.

      Captura de tela mostrando a página Criar Assinatura de Evento com a opção

  4. Na página Selecionar Tópico do Namespace da Grade de Eventos, siga essas etapas:

    1. Para Assinatura, selecione a assinatura do Azure, o grupo de recursos e o namespace que contém o tópico do namespace.
    2. Para Tópico do namespace da Grade de Eventos, selecione o tópico do namespace.
    3. Selecione Confirmar seleção na parte inferior da página.
  5. Agora, na página Criar Assinatura de Evento, para Tipo de identidade gerenciada, selecione Atribuída pelo sistema.

  6. Selecione Criar na parte inferior da página.

    Captura de tela que mostra como criar uma assinatura para encaminhar eventos do tópico básico da Grade de Eventos para o namespace da Grade de Eventos.

    Para testar o cenário, crie um contêiner no armazenamento de blobs do Azure e carregue um arquivo. Verifique se o manipulador de eventos ou o ponto de extremidade do tópico do namespace recebem o evento criado pelo blob.

    Quando você carrega um blob em um contêiner no armazenamento do Azure, veja o que acontece:

    1. O Armazenamento de Blobs do Azure envia um evento Criado pelo Blob para o tópico do sistema do seu armazenamento de blobs.
    2. O evento é encaminhado para o seu tópico do namespace, já que esse é o manipulador de eventos ou o ponto de extremidade do tópico do sistema.
    3. O ponto de extremidade para a assinatura do tópico do namespace recebe o evento encaminhado.

Veja os artigos a seguir: