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. 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. É possível especificar uma conta de serviço gerenciada pelo usuário a ser usada pelo gatilho como uma identidade padrão. Certifique-se de conceder os papéis e permissões necessários à conta de serviço do gatilho.

    Por exemplo, para enviar eventos a um serviço do Cloud Run que autenticação, a conta de serviço do Eventarc gatilho precisa ter o papel do IAM do invocador do Cloud Run função.

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