Configurar um gatilho do Eventarc

Pré-lançamento particular

Esse produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Esta página descreve como configurar um gatilho do Eventarc no Application Integration.

Um gatilho do Eventarc permite executar integrações com base em eventos roteados por Eventarc Standard. Usando um gatilho do Eventarc, você 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, é possível usar o gatilho para iniciar uma integração quando um novo objeto é enviado a um bucket do Cloud Storage.

Noconsol, é possível criar e configurar um gatilho do Eventarc das seguintes maneiras: Google Cloud

• Usando o Application Integration
• Usando o Eventarc

Antes de começar

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

Funções necessárias para ativar APIs

Para ativar as APIs, é necessário ter a permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pela função Proprietário (roles/owner). Caso contrário, você pode receber essa permissão pela função Administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin). Saiba como conceder funções.

Ativar as APIs

Considerações

Considere o seguinte ao configurar um gatilho do Eventarc:

• Se a criação do gatilho do Eventarc falhar durante a publicação da integração devido a erros de configuração, a integração ainda será publicada, mas o gatilho não estará ativo.

  Para corrigir isso, cancele a publicação da integração, revise e corrija cuidadosamente a configuração do gatilho do Eventarc e, em seguida, republique a integração. É possível verificar o status da criação do gatilho do Eventarc clicando (Notificação) na barra de ferramentas do console do Google Cloud.

• A publicação de uma nova versão da integração com uma configuração modificada do gatilho do Eventarc substitui automaticamente o gatilho antigo por um novo. Isso garante que sua integração sempre use a configuração de gatilho mais recente e exclua gatilhos obsoletos.
• Se você publicar uma nova versão da integração e usar o mesmo gatilho do Eventarc e a configuração dele, um novo gatilho não será criado. Em vez disso, o gatilho do Eventarc atual será reutilizado para a nova versão da integração.

Criar um gatilho do Eventarc no Application Integration

Para criar um gatilho do Eventarc no Application Integration, siga estas etapas:

1. Adicionar o gatilho do Eventarc no Application Integration
2. Configurar o gatilho do Eventarc no editor de integração

Adicionar o gatilho do Eventarc

Para adicionar um gatilho do Eventarc à integração, siga estas etapas:

1. Noconsol, acesse a página Application Integration. Google Cloud

   Acessar o Application Integration

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

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

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

   Se você estiver criando uma nova integração:

   1. Insira um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel de informações Resumo da integração na barra de ferramentas de integração.
      Observação:a opção para selecionar uma conta de serviço só será exibida se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

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

4. Na barra de navegação do editor de integração, clique em Gatilhos para conferir a lista de gatilhos disponíveis.
5. Arraste e solte o elemento Eventarc no editor de integração.

Configurar o gatilho do Eventarc

Para configurar um gatilho do Eventarc, clique no Gatilho do Eventarc elemento no editor de integração. O painel de configuração Gatilho do Eventarc aparece mostrando os seguintes campos:

• Rótulo : (opcional) o nome visível do gatilho do Eventarc na integração. É possível mudar o rótulo para um nome de sua escolha.
• Observações : (opcional) é possível adicionar observações para fornecer mais informações sobre o gatilho.
• Clique em Configurar gatilho do Eventarc e forneça as seguintes entradas no editor de gatilho do Eventarc:
  • Nome do gatilho: insira um nome para o gatilho.
  • Tipo de gatilho: selecione um dos seguintes tipos de gatilho:
    • Origem do Google: selecione essa opção para criar um gatilho para o Pub/Sub, o Cloud Storage, o Firestore e outros provedores de eventos do Google.
    • Personalizado: selecione essa opção para criar um gatilho para uma origem de eventos personalizada.
    • Terceiros: selecione essa opção para criar um gatilho para provedores que não são do Google que oferecem uma origem do Eventarc. Para mais informações, consulte Eventos de terceiros no Eventarc.
  • Provedor de eventos: selecione o provedor de eventos para o gatilho. A lista de provedores de eventos depende do tipo de gatilho. Para mais informações, consulte Provedores e destinos de eventos.
  • Tipo de evento: selecione o tipo de evento para o gatilho. A configuração do gatilho varia de acordo com o provedor de eventos selecionado. Para mais informações, consulte Tipos de eventos.
  • Região: selecione a região do gatilho.
    Dica: para um desempenho ideal e para minimizar a latência, verifique se o gatilho do Eventarc, o recurso monitorado Google Cloud e o serviço estão localizados na mesmaregião. Google Cloud
  • Filtros: (opcional) adicione filtros para selecionar as APIs que correspondem aos seus critérios. Por exemplo, se você filtrar as APIs por um nome específico, o evento será acionado somente se as APIs que correspondem aos critérios de filtro forem atualizadas.
  • Conta de serviço: selecione a conta de serviço a ser usada para o gatilho. Se você não selecionar uma conta de serviço, o gatilho usará a conta de serviço padrão do Compute Engine como identidade ao invocar o serviço. A conta de serviço associada ao gatilho precisa ter as permissões necessárias para invocar o serviço.

  • Tentar novamente em caso de falha: selecione para ativar novas tentativas de gatilho se o destino não conseguir processar o evento.
  • Anexo de rede: selecione o anexo de rede a ser usado para o gatilho. Essa lista é gerada com base nos anexos de rede criados no projeto.

    Os anexos de rede facilitam a comunicação entre redes de nuvem privada virtual (VPC) do produtor de serviços e redes VPC do consumidor. O Eventarc usa o anexo de rede configurado para estabelecer uma conexão com um endpoint HTTP interno hospedado na rede VPC do consumidor, permitindo a entrega de dados de eventos. Para mais informações sobre como criar e gerenciar anexos de rede, consulte Criar e gerenciar anexos de rede.

• Para salvar a configuração do gatilho, clique em Salvar gatilho.
Observação: salvar a configuração do gatilho do Eventarc define as regras que determinam quando e como o Eventarc responde a eventos. Essa configuração é armazenada como parte da definição do gatilho no Application Integration. No entanto, essas regras não são aplicadas imediatamente. É necessário publicar a integração para implantar essas regras e ativar o gatilho do Eventarc. Até a publicação, o gatilho permanece inativo e não processa eventos. Para informações sobre como publicar integrações, consulte Publicar integrações.

Criar um gatilho do Eventarc usando o console do Eventarc

Para criar um gatilho do Eventarc na página do console do Eventarc, siga estas etapas:

1. Noconsol, acesse a página Eventarc > Gatilhos. Google Cloud

   Acessar gatilhos

   A página Gatilhos lista todos os gatilhos do projeto.

2. Clique em Criar gatilho.
3. Na página Criar gatilho, forneça as seguintes entradas:
   1. Nome do gatilho: insira um nome para o gatilho.
   2. Tipo de gatilho: selecione um dos seguintes tipos de gatilho:
      • Origens do Google: selecione essa opção para criar um gatilho para o Pub/Sub, Cloud Storage, Firestore e outros provedores de eventos do Google.
      • Personalizado: selecione essa opção para criar um gatilho para uma origem de eventos personalizada.
      • Terceiros: selecione essa opção para criar um gatilho para provedores que não são do Google que oferecem uma origem do Eventarc. Para mais informações, consulte Eventos de terceiros no Eventarc.
   3. Provedor de eventos: selecione o provedor de eventos para o gatilho. A lista de provedores de eventos depende do tipo de gatilho. Para mais informações, consulte Provedores e destinos de eventos.
   4. Tipo de evento: selecione o tipo de evento para o gatilho. A configuração do gatilho varia de acordo com o provedor de eventos selecionado. Para mais informações, consulte Tipos de eventos.
   5. Tipo de conteúdo de 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 do gatilho.
      Dica: para um desempenho ideal e para minimizar a latência, verifique se o gatilho do Eventarc, o recurso monitorado do Google Cloud e o serviço estão localizados na mesma Google Cloud região.
   7. Conta de serviço: selecione a conta de serviço a ser usada para o gatilho. Se você não selecionar uma conta de serviço, o gatilho usará a conta de serviço padrão do Compute Engine como identidade ao invocar o serviço. A conta de serviço associada ao gatilho precisa ter as permissões necessárias para invocar o serviço.
   8. Destino do evento: selecione Application Integration.
   9. Selecionar uma integração: selecione a integração para a qual você quer criar o gatilho. Se a integração for publicada, o Application Integration criará uma nova versão de rascunho da integração para adicionar o gatilho do Eventarc.
   10. Anexo de rede: selecione o anexo de rede a ser usado para o gatilho. Essa lista é gerada com base nos anexos de rede criados no projeto.

       Os anexos de rede facilitam a comunicação entre redes de nuvem privada virtual (VPC) do produtor de serviços e redes VPC do consumidor. O Eventarc usa o anexo de rede configurado para estabelecer uma conexão com um endpoint HTTP interno hospedado na rede VPC do consumidor, permitindo a entrega de dados de eventos. Para mais informações sobre anexos de rede, consulte Sobre anexos de rede.

4. Clique em Abrir integração.

   A página do editor do Application Integration será aberta com a integração selecionada e o novo elemento Gatilho do Eventarc adicionado à integração.

5. Clique no elemento Gatilho do Eventarc e abra o painel de configuração do gatilho.
6. Revise e verifique a configuração do gatilho na página Editor de gatilho do Eventarc.
7. Conecte o novo gatilho do Eventarc ao fluxo de integração e publique a integração.
Observação:é necessário publicar a integração para implantar e ativar o gatilho do Eventarc. Até a publicação, o gatilho permanece inativo e não processa eventos. Para informações sobre como publicar integrações, consulte Testar e publicar integrações.