Um gatilho do Eventarc declara seu interesse em um determinado evento ou conjunto de eventos. Para configurar o roteamento de eventos, especifique filtros para o gatilho, incluindo a origem do evento e o serviço de destino do Cloud Run.
O Eventarc entrega eventos ao receptor de eventos no formato CloudEvents por uma solicitação HTTP.
Nestas instruções, mostramos como configurar o roteamento de eventos para o serviço do Cloud Run que é acionado por um evento Firebase Realtime Database direto. Para saber mais, consulte a lista de eventos diretos compatíveis.
Preparar para criar um gatilho
Antes de criar um gatilho, atenda aos seguintes pré-requisitos:
Console
No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
Ative as APIs Cloud Logging, Eventarc e Eventarc Publishing.
Se aplicável, ative a API relacionada aos eventos diretos. Por exemplo, para eventos Firebase Realtime Database , ative a APIFirebase Realtime Database .
Se você ainda não tiver uma, crie uma conta de serviço gerenciada pelo usuário e conceda a ela os papéis e as permissões necessários para que o Eventarc gerencie os eventos do serviço de destino.
No Console do Google Cloud, acesse a página Criar conta de serviço.
Selecione o projeto.
No campo Nome da conta de serviço, insira um nome. O Console do Google Cloud preenche o campo ID da conta de serviço com base nesse nome.
No campo Descrição da conta de serviço, insira uma descrição. Por exemplo,
Service account for event trigger
.Clique em Criar e continuar.
Para fornecer o acesso apropriado, na lista Selecionar um papel, escolha os papéis necessários do Identity and Access Management (IAM) a serem concedidos à conta de serviço no caso de invocações autenticadas ou não autenticadas. Para mais informações, consulte Papéis e permissões para os destinos do Cloud Run.
Para papéis adicionais, clique em
Adicionar outro papel e adicione cada papel adicional.Clique em Continuar.
Para concluir a criação da conta de serviço, clique em Concluído.
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Ative as APIs Cloud Logging, Eventarc e Eventarc Publishing.
gcloud services enable logging.googleapis.com \ eventarc.googleapis.com \ eventarcpublishing.googleapis.com
Se aplicável, ative a API relacionada aos eventos diretos. Por exemplo, para eventos Firebase Realtime Database , ative
firebasedatabase.googleapis.com
.Se você ainda não tiver uma, crie uma conta de serviço gerenciada pelo usuário e conceda a ela os papéis e as permissões necessários para que o Eventarc gerencie os eventos do serviço de destino.
Crie a conta de serviço:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
Substitua
SERVICE_ACCOUNT_NAME
pelo nome da conta de serviço. Ele precisa ter entre 6 e 30 caracteres e pode conter letras minúsculas, caracteres alfanuméricos e traços. Depois da criação, não é possível alterar o nome da conta de serviço.Conceda os papéis ou as permissões do Identity and Access Management (IAM) necessários para invocações autenticadas ou não autenticadas. Para mais informações, consulte Papéis e permissões para destinos do Cloud Run.
Criar um gatilho
É possível criar um gatilho do Eventarc usando a CLI do Google Cloud ou o console do Google Cloud.
Console
- No Console do Google Cloud, acesse a página Gatilhos do Eventarc.
- Clique em Criar gatilho.
- Digite um Nome de gatilho.
Esse é o ID do gatilho e precisa começar com uma letra. Ele pode conter até 63 letras minúsculas, números ou hífens.
- Em Tipo de gatilho, selecione Fontes do Google.
- Na lista Provedor de eventos, selecione
Firebase Realtime Database.
O nome do provedor de eventos usado na documentação do Google Cloud associada pode não ter o prefixo Cloud ou Google Cloud. Por exemplo, no console, o Memorystore para Redis é chamado de Google Cloud Memorystore para Redis.
- Na lista Tipo de evento, nos eventos Diretos, selecione um tipo de evento.
- Na lista Tipo de conteúdo de dados do evento, selecione a codificação
do payload do evento.
Para eventos diretos de Firebase Realtime Database, ele precisa ser application/json.
- Na lista Região, selecione a mesma região do
serviço do Google Cloud que está gerando eventos.
Saiba mais em Locais do Eventarc.
- No campo Atributo 1, o ID do recurso
da instância atua como um
filtro de evento. Selecione um operador para esse filtro:
- Igual
- Padrão de caminho
Para mais informações, consulte Entender os padrões de caminho.
- No campo Valor de atributo 1, digite o nome da instância do banco de dados que receberá os eventos. Dependendo do operador que você escolheu na etapa anterior, o valor do atributo precisa ser o nome exato ou um formato de padrão de caminho.
- Para o atributo ref, selecione o operador Padrão de caminho.
- No campo Valor do atributo 2, insira o caminho da instância do banco de dados para receber eventos se os dados forem criados, atualizados ou excluídos nesse caminho ou em qualquer caminho secundário.
- Selecione a conta de serviço que vai invocar seu serviço
ou fluxo de trabalho.
ou crie uma nova conta de serviço.
Ele especifica o e-mail da conta de serviço do Identity and Access Management (IAM) associado ao gatilho e aos quais você já concedeu papéis específicos exigidos pelo Eventarc.
- Na lista Destino do evento, selecione Cloud Run.
- Selecione um serviço.
Esse é o nome do serviço que recebe os eventos do gatilho. O serviço precisa estar no mesmo projeto que o gatilho e receberá eventos como solicitações POST HTTP enviadas para o caminho de URL raiz (
/
) sempre que o evento for gerado. - Se preferir, 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. Por exemplo:
/
,/route
,route
,route/subroute
. - Clique em Criar.
Depois que um gatilho é criado, os filtros da origem de eventos não podem ser modificados. Crie um novo gatilho e exclua o antigo. Para mais informações, consulte Gerenciar acionadores.
gcloud
Para criar um gatilho, execute um comando gcloud eventarc triggers create
com as flags obrigatórias e opcionais.
gcloud eventarc triggers create TRIGGER \ --location=LOCATION \ --destination-run-service=DESTINATION_RUN_SERVICE \ --destination-run-region=DESTINATION_RUN_REGION \ --event-filters="type=EVENT_FILTER_TYPE" \ --event-filters="instance=INSTANCE" \ --event-filters-path-pattern="ref=REF" \ --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
Substitua:
TRIGGER
: o ID do gatilho ou um identificador totalmente qualificado.
LOCATION
: o local do gatilho do Eventarc. Como alternativa, é possível definir a propriedadeeventarc/location
. Por exemplo:gcloud config set eventarc/location us-central1
.Os gatilhos do Firebase Realtime Database para Eventarc estão disponíveis apenas em determinados locais, e o gatilho precisa estar no mesmo local que a instância do Firebase Realtime Database. Para mais informações, consulte Locais do Eventarc e Locais do Realtime Database.
-
DESTINATION_RUN_SERVICE
: o nome do serviço do Cloud Run que recebe os eventos do gatilho. O serviço pode estar em qualquer um dos locais compatíveis com o Cloud Run e não precisa estar no mesmo local que o gatilho. No entanto, o serviço precisa estar no mesmo projeto que o gatilho e receberá eventos como solicitações POST HTTP enviadas para o caminho de URL raiz (/
) sempre que o evento for gerado. -
DESTINATION_RUN_REGION
: (opcional) a região em que o serviço de destino do Cloud Run pode ser encontrado. Se não especificado, presume-se que o serviço está na mesma região que o gatilho EVENT_FILTER_TYPE
: o identificador do evento do Firebase Realtime Database e pode ser um dos seguintes:google.firebase.database.ref.v1.created
: o evento é enviado quando os dados são criados no banco de dadosgoogle.firebase.database.ref.v1.updated
: o evento é enviado quando os dados são atualizados no banco de dadosgoogle.firebase.database.ref.v1.deleted
: o evento é enviado quando os dados são excluídos do banco de dadosgoogle.firebase.database.ref.v1.written
: o evento é enviado quando os dados são criados, atualizados ou excluídos no banco de dados
INSTANCE
: uma única instância de banco de dados e o operador podem ser um dos seguintes:- Igual por exemplo,
--event-filters="instance=INSTANCE"
- Padrão do caminho por exemplo,
--event-filters-path-pattern="instance=INSTANCE"
. Para mais informações, consulte Entender os padrões de caminho.
- Igual por exemplo,
REF
: o caminho dentro da instância do banco de dados de que você quer receber eventos quando os dados são criados, atualizados ou excluídos nesse caminho ou em qualquer um dos filhos.SERVICE_ACCOUNT_NAME
: o nome da conta de serviço gerenciada pelo usuário.PROJECT_ID
: é seu ID do projeto no Google Cloud.
Observações:
- Para eventos diretos de Firebase Realtime Database, a codificação
do payload do evento é
application/json
. - Estas flags são necessárias:
--event-filters="type=EVENT_FILTER_TYPE"
--event-filters="instance=INSTANCE"
ou--event-filters-path-pattern="instance=INSTANCE"
--event-filters-path-pattern="ref=REF"
- Após a criação de um gatilho, o tipo do filtro de evento não pode ser alterado. Para um tipo de evento diferente, crie um novo gatilho.
- A sinalização
--service-account
é usada para especificar o e-mail da conta de serviço do Identity and Access Management (IAM) associado ao gatilho. - Como opção, especifique um caminho relativo no serviço de destino
do Cloud Run para o qual os eventos do gatilho precisam ser enviados usando a
sinalização
--destination-run-path
.
Exemplo:
gcloud eventarc triggers create helloworld-trigger \ --location=us-central1 \ --destination-run-service=helloworld-events \ --destination-run-region=us-central1 \ --event-filters="type=google.firebase.database.ref.v1.created" \ --event-filters="instance=test-instance" \ --event-filters-path-pattern="ref=users/*" \ --service-account=${SERVICE_ACCOUNT_NAME}@${PROJECT_ID}.iam.gserviceaccount.com
Esse comando cria um gatilho chamado helloworld-trigger
para o evento
identificado como google.firebase.database.ref.v1.created
e para o
caminho users/*
na instância do banco de dados identificada como test-instance
.
Terraform
É possível criar um gatilho para um destino do Cloud Run usando o Terraform. Para mais detalhes, acesse Criar um gatilho usando o Terraform.
Listar um gatilho
É possível confirmar a criação de um gatilho listando os gatilhos do Eventarc usando a CLI do Google Cloud ou o console do Google Cloud.
Console
No Console do Google Cloud, acesse a página Gatilhos do Eventarc.
Confira nesta página os gatilhos em todos os locais e os detalhes como nomes, regiões, provedores de eventos, destinos e muito mais.
Para filtrar os gatilhos, siga estas etapas:
- Clique em Filtrar ou no campo Filtrar gatilhos.
- Na lista Propriedades, selecione uma opção para filtrar os gatilhos.
É possível selecionar uma única propriedade ou usar o operador lógico
OR
para adicionar mais propriedades.Para classificar gatilhos, ao lado de qualquer cabeçalho de coluna com suporte, clique em
Ordenar.
gcloud
Execute o comando a seguir para listar os gatilhos:
gcloud eventarc triggers list --location=-
Esse comando lista os gatilhos em todos os locais e inclui detalhes como nomes, tipos, destinos e status.