Configure um acionador do Eventarc

Pré-visualização privada

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais do Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Esta página descreve como configurar um acionador do Eventarc na integração de aplicações.

Um acionador do Eventarc permite-lhe executar integrações com base em eventos encaminhados através do Eventarc Standard. Usando um acionador do Eventarc, pode criar fluxos de integração acionados por eventos de vários Google Cloud serviços, serviços de terceiros e origens de eventos personalizados. Por exemplo, pode usar o acionador para iniciar uma integração quando um novo objeto é carregado para um contentor do Cloud Storage.

Na Google Cloud consola, pode criar e configurar um acionador do Eventarc das seguintes formas:

• Usar a integração de aplicações
• Usar o Eventarc

Antes de começar

Antes de configurar o acionador do Eventarc, ative a API Eventarc e a API Pub/Sub:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Considerações

Considere o seguinte ao configurar um acionador do Eventarc:

• Se a criação do acionador do Eventarc falhar durante a publicação da integração devido a erros de configuração, a integração é publicada na mesma, mas o acionador não fica ativo.

  Para corrigir este problema, anule a publicação da integração, reveja e corrija cuidadosamente a configuração do acionador do Eventarc e, em seguida, republique a integração. Pode verificar o estado de criação do acionador do Eventarc clicando em (Notificação) na barra de ferramentas da Google Cloud Console.

• A publicação de uma nova versão da sua integração com uma configuração do acionador do Eventarc modificada substitui automaticamente o acionador antigo por um novo. Isto garante que a sua integração usa sempre a configuração do acionador mais recente e elimina todos os acionadores obsoletos.
• Se publicar uma nova versão da sua integração e usar o mesmo acionador do Eventarc e a respetiva configuração, não é criado um novo acionador. Em alternativa, o acionador do Eventarc existente é reutilizado para a nova versão de integração.

Crie um acionador do Eventarc a partir da integração de aplicações

Para criar um acionador do Eventarc a partir da integração de aplicações, siga estes passos:

1. Adicione o acionador do Eventarc na integração de aplicações
2. Configure o acionador do Eventarc no editor de integração

Adicione o acionador do Eventarc

Para adicionar um acionador do Eventarc à sua integração, conclua os seguintes passos:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

2. No menu de navegação, clique em Integrações

   A página Lista de integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

   Se estiver a criar uma nova integração:

   1. Introduza um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
   3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
      Nota: a opção para selecionar uma conta de serviço só é apresentada se tiver ativado a gestão da integração para a região selecionada.
   4. Clique em Criar.

   A integração recém-criada é aberta no editor de integração.

4. Na barra de navegação do editor de integração, clique em Acionadores para ver a lista de acionadores disponíveis.
5. Arraste e largue o elemento Eventarc no editor de integração.

Configure o acionador do Eventarc

Para configurar um acionador do Eventarc, clique no elemento Acionador do Eventarc no editor de integração. O painel de configuração do acionador do Eventarc é apresentado com os seguintes campos:

• Etiqueta: (opcional) o nome visível do acionador do Eventarc na sua integração. Pode alterar a etiqueta para um nome à sua escolha.
• Notas: (opcional) pode adicionar notas para fornecer informações adicionais sobre o acionador.
• Clique em Configurar acionador do Eventarc e introduza as seguintes informações no editor de acionadores do Eventarc:
  • Nome do acionador: introduza um nome para o acionador.
  • Tipo de acionador: selecione um dos seguintes tipos de acionador:
    • Origem Google: selecione esta opção para criar um acionador para o Pub/Sub, o Cloud Storage, o Firestore e outros fornecedores de eventos Google.
    • Personalizado: selecione esta opção para criar um acionador para uma origem de eventos personalizada.
    • Terceiros: selecione esta opção para criar um acionador para fornecedores não pertencentes à Google que oferecem uma origem do Eventarc. Para mais informações, consulte o artigo Eventos de terceiros no Eventarc.
  • Fornecedor de eventos: selecione o fornecedor de eventos para o acionador. A lista de fornecedores de eventos depende do tipo de acionador. Para mais informações, consulte o artigo Fornecedores e destinos de eventos.
  • Tipo de evento: selecione o tipo de evento para o acionador. A configuração do acionador varia consoante o fornecedor de eventos que selecionar. Para mais informações, consulte o artigo Tipos de eventos.
  • Região: selecione a região para o acionador.
    Sugestão: para um desempenho ideal e para minimizar a latência, certifique-se de que o acionador do Eventarc, o recurso Google Cloud monitorizado e o seu serviço estão todos localizados na mesma Google Cloud região.
  • Filtros: (opcional) adicione filtros para selecionar as APIs que correspondem aos seus critérios. Por exemplo, se filtrar as APIs por um nome específico, o evento só é acionado se as APIs que correspondem aos critérios de filtro forem atualizadas.
  • Conta de serviço: selecione a conta de serviço a usar para o acionador. Se não selecionar uma conta de serviço, o acionador usa a conta de serviço predefinida do Compute Engine como a respetiva identidade quando invoca o seu serviço. A conta de serviço associada ao acionador tem de ter as autorizações necessárias para invocar o seu serviço.

  • Tentar novamente em caso de falha: selecione esta opção para ativar as novas tentativas de acionamento se o destino não conseguir processar o evento.
  • Anexo de rede: selecione o anexo de rede a usar para o acionador. Esta lista é gerada com base nas associações de rede criadas no seu projeto.

    As associações de rede facilitam a comunicação entre as redes da nuvem virtual privada (VPC) do produtor de serviços e as redes da VPC do consumidor. O Eventarc usa a associação de rede configurada para estabelecer uma ligação a um ponto final HTTP interno alojado na rede VPC do consumidor, o que permite a entrega de dados de eventos. Para mais informações sobre como criar e gerir associações de rede, consulte o artigo Crie e faça a gestão de associações de rede.

• Para guardar a configuração do acionador, clique em Guardar acionador.
Nota: guardar a configuração do acionador do Eventarc define as regras que determinam quando e como o Eventarc responde aos eventos. Esta configuração é armazenada como parte da definição do acionador na integração de aplicações. No entanto, estas regras não são aplicadas imediatamente. Tem de publicar a integração para implementar estas regras e ativar o acionador do Eventarc. Até ser publicado, o acionador permanece inativo e não processa eventos. Para obter informações sobre a publicação de integrações, consulte Publicar integrações.

Crie um acionador do Eventarc através da consola do Eventarc

Para criar um acionador do Eventarc a partir da página da consola do Eventarc, siga estes passos:

1. Na Google Cloud consola, aceda à página Eventarc > Acionadores.

   Aceda a Acionadores

   A página Acionadores lista todos os acionadores no seu projeto.

2. Clique em Criar acionador.
3. Na página Criar acionador, introduza as seguintes informações:
   1. Nome do acionador: introduza um nome para o acionador.
   2. Tipo de acionador: selecione um dos seguintes tipos de acionador:
      • Origens Google: selecione esta opção para criar um acionador para o Pub/Sub, o Cloud Storage, o Firestore e outros fornecedores de eventos Google.
      • Personalizado: selecione esta opção para criar um acionador para uma origem de eventos personalizada.
      • Terceiros: selecione esta opção para criar um acionador para fornecedores não pertencentes à Google que oferecem uma origem do Eventarc. Para mais informações, consulte o artigo Eventos de terceiros no Eventarc.
   3. Fornecedor de eventos: selecione o fornecedor de eventos para o acionador. A lista de fornecedores de eventos depende do tipo de acionador. Para mais informações, consulte o artigo Fornecedores e destinos de eventos.
   4. Tipo de evento: selecione o tipo de evento para o acionador. A configuração do acionador varia consoante o fornecedor de eventos que selecionar. Para mais informações, consulte o artigo Tipos de eventos.
   5. Tipo de conteúdo dos dados de eventos: selecione o tipo de dados para o conteúdo do evento. Selecione application/json ou application/protobuf.
   6. Região: selecione a região para o acionador.
      Sugestão: para um desempenho ideal e para minimizar a latência, certifique-se de que o acionador do Eventarc, o recurso do Google Cloud monitorizado e o seu serviço estão todos localizados na mesma Google Cloud região.
   7. Conta de serviço: selecione a conta de serviço a usar para o acionador. Se não selecionar uma conta de serviço, o acionador usa a conta de serviço predefinida do Compute Engine como identidade quando invoca o seu serviço. A conta de serviço associada ao acionador tem de ter as autorizações necessárias para invocar o seu serviço.
   8. Destino do evento: selecione Integração de aplicações.
   9. Selecione uma integração: selecione a integração para a qual quer criar o acionador. Se a integração for publicada, a Application Integration cria uma nova versão de rascunho da integração à qual adicionar o acionador do Eventarc.
   10. Anexo de rede: selecione o anexo de rede a usar para o acionador. Esta lista é gerada com base nas associações de rede criadas no seu projeto.

       As associações de rede facilitam a comunicação entre redes da nuvem virtual privada (VPC) do produtor de serviços e redes da VPC do consumidor. O Eventarc usa o anexo de rede configurado para estabelecer uma ligação a um ponto final HTTP interno alojado na rede VPC do consumidor, o que permite a entrega de dados de eventos. Para mais informações sobre anexos de rede, consulte Acerca dos anexos de rede.

4. Clique em Abrir integração.

   A página do editor de integração de aplicações é aberta com a integração selecionada e o novo elemento Acionador do Eventarc adicionado à integração.

5. Clique no elemento Acionador do Eventarc e abra o painel de configuração do acionador.
6. Reveja e valide a configuração do acionador na página Editor de acionadores do Eventarc.
7. Associe o novo acionador do Eventarc ao fluxo de integração e publique a integração.
Nota: tem de publicar a integração para implementar e ativar o acionador do Eventarc. Até ser publicado, o acionador permanece inativo e não processa eventos. Para obter informações sobre a publicação de integrações, consulte o artigo Teste e publique integrações.