Acionar com eventos

O Eventarc é um serviço do Google Cloud que permite criar arquiteturas orientadas a eventos sem ter que implementar, personalizar ou manter a infraestrutura subjacente.

Para criar um acionador do Eventarc, especifique filtros para o acionador e configure o roteamento do evento, incluindo a origem do evento e o serviço de destino do Cloud Run. Quando o evento ou o conjunto de eventos especificados correspondem aos filtros, o serviço do Cloud Run é invocado automaticamente em resposta aos eventos.

Os eventos enviados para o serviço do Cloud Run são recebidos na forma de solicitações HTTP.

Os seguintes tipos de evento acionam solicitações para seu serviço:

Nesta página, mostramos como criar um gatilho para um serviço na página do console do Cloud Run. Para instruções semelhantes sobre como criar um gatilho para uma função, consulte Implantar funções no Cloud Run.

Também é possível criar um gatilho do Eventarc usando a Google Cloud CLI ou na página do console do Eventarc. Para instruções sobre como criar um gatilho para um provedor, tipo de evento e destino específicos, filtre a lista para saber mais sobre os provedores e destinos de eventos do Eventarc.

Antes de começar

Antes de criar um gatilho com o Eventarc, entenda os papéis necessários para a identidade do gatilho.

  1. Ativar a API Eventarc

    Ativar a API

  2. Cada gatilho do Eventarc está associado a uma conta de serviço do Identity and Access Management (IAM) no momento em que o gatilho é criado. Essa conta de serviço é conhecida como conta de serviço do acionador e é usada para invocar a API Eventarc. Por exemplo, para enviar eventos a um serviço do Cloud Run que requer autenticação, verifique se a identidade do gatilho recebeu o papel IAM do Invocador do Cloud Run (roles/run.invoker).

  3. Se você estiver criando um gatilho para um evento direto do Cloud Storage, conceda o papel pubsub.publisher à conta de serviço do Cloud Storage:

    SERVICE_ACCOUNT="$(gcloud storage service-agent --project=PROJECT_ID)"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:${SERVICE_ACCOUNT}" \
    --role='roles/pubsub.publisher'

    Substitua PROJECT_ID pelo ID do projeto do Google Cloud. Encontre o ID do projeto na página Boas-vindas do console do Google Cloud.

Criar um gatilho

Depois de implantar o serviço, use a página do console do Cloud Run para criar um gatilho do Eventarc.

  1. No console do Google Cloud, acesse o Cloud Run.

    Acesse o Cloud Run

  2. Na lista de serviços, clique em um serviço atual ou crie um novo.

  3. Na página "Detalhes do serviço", clique na guia Acionadores.

  4. Clique em Adicionar gatilho do Eventarc.

    O painel Gatilho do Eventarc é aberto. Para determinar a melhor maneira de rotear eventos, consulte Opções de roteamento de eventos.

  5. Siga as instruções para criar um gatilho para um provedor, tipo de evento e destino específicos e consulte as instruções do Console. na seção "Criar um gatilho".

  6. Selecione a conta de serviço que invoca o serviço do Cloud Run ou crie uma nova conta de serviço.

    Ele especifica o e-mail da conta de serviço do IAM associado ao gatilho. Para destinos do Cloud Run, essa conta de serviço é usada para gerar tokens de identidade ao invocar o serviço.

  7. Se quiser, especifique o caminho do URL do serviço para enviar a solicitação recebida.

    Esse é o caminho relativo no serviço de destino para o qual os eventos do gatilho precisam ser enviados. Exemplo: /, /route, route, route/subroute.

  8. Depois de criar o gatilho, verifique a integridade garantindo que haja uma marca de seleção na guia Gatilhos.

A seguir