Acionar com eventos

É possível criar um gatilho do Eventarc para que o serviço do Cloud Run receba notificações de um evento especificado ou conjunto de eventos. Ao especificar filtros para o gatilho, é possível configurar o roteamento do evento, incluindo a origem do evento e o serviço de destino do Cloud Run.

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 por meio da página do console do Cloud Run.

Também é possível criar um gatilho do Eventarc usando a Google Cloud CLI ou na página do console do Eventarc. Siga as instruções para criar um gatilho para um provedor, um tipo de evento e um destino específicos.

Preparar para criar um gatilho

Antes de criar um gatilho, atenda aos seguintes pré-requisitos:

  1. O Eventarc usa uma conta de serviço fornecida pelo cliente como identidade do gatilho. Certifique-se de conceder os papéis e permissões necessários à conta de serviço do gatilho.

    Por exemplo, para enviar eventos para um serviço do Cloud Run que requer autenticação, a conta de serviço do gatilho do Eventarc precisa ter o papel de gerenciamento de identidade e acesso (IAM) do invocador do Cloud Run.

  2. 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="$(gsutil kms serviceaccount -p 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 pelo console

Use a página do console do Cloud Run para criar um gatilho do Eventarc.

  1. Se necessário, ative a API Eventarc.

    Ativar a API

  2. No Console do Google Cloud, acesse o Cloud Run.

    Acesse o Cloud Run

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

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

  5. 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.

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

  7. 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.

  8. 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.

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

A seguir