Nesta página, mostramos como criar um gatilho do Eventarc para que um serviço do Cloud Run possa receber eventos de outro serviço do Google Cloud .
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 gatilho do Eventarc, especifique filtros para o gatilho 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. Um serviço que usa gatilhos do Eventarc é chamado de serviço orientado a 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 podem acionar solicitações para seu serviço:
- Registros de auditoria que correspondem aos critérios de filtro do gatilho
- Eventos diretos, como uma atualização de um bucket do Cloud Storage
- Mensagens diretas publicadas em um tópico do Pub/Sub
Local do gatilho
Ao criar um gatilho do Eventarc, você especifica um local para ele. Ele precisa corresponder ao local do recurso do Google Cloud que você quer monitorar para eventos. Na maioria dos cenários, você também precisa implantar o serviço do Cloud Run orientado por eventos na mesma região. Para ver mais informações, consulte Entender os locais do Eventarc.
Identidade do acionador
Ao criar um gatilho do Eventarc, você especifica uma conta de serviço do Identity and Access Management (IAM) para ele. O gatilho usa essa conta de serviço como identidade padrão. Recomendamos que você especifique uma conta de serviço gerenciado pelo usuário e conceda a ela as permissões mínimas necessárias.
Antes de começar
Ative o Artifact Registry, o Cloud Build, a API Cloud Run Admin e as APIs Eventarc:
Criar um gatilho para serviços
Depois de implantar um serviço, é possível configurar um gatilho usando o console do Google Cloud , a Google Cloud CLI ou o Terraform.
Console
Implante o serviço do Cloud Run usando contêineres ou da origem.
No console do Google Cloud , acesse o Cloud Run:
Na lista de serviços, clique em um serviço atual.
Na página de detalhes do serviço, acesse a guia Gatilhos.
Clique em Adicionar gatilho e selecione uma opção.
No painel Gatilho do Eventarc, modifique os detalhes do gatilho da seguinte maneira:
No campo Nome do gatilho, digite um nome ou use o nome padrão.
Selecione um Tipo de acionador na lista para especificar um dos seguintes tipos de acionador:
Fontes do Google para especificar acionadores para Pub/Sub, Cloud Storage, Firestore, e outros provedores de eventos do Google.
Terceiros para integração com provedores que não são do Google que oferecem uma origem do Eventarc. Para mais informações, consulte Eventos de terceiros no Eventarc.
Selecione um provedor de eventos na lista Provedor de eventos para selecionar um produto que ofereça o tipo de evento para acionar seu serviço. Para ver a lista de provedores de eventos, consulte Provedores e destinos de eventos.
Selecione um tipo de evento na lista Tipo de evento. A configuração do gatilho varia de acordo com o tipo de evento compatível: Para mais informações, consulte Tipos de eventos.
Se o campo Região estiver ativado, selecione um local para o gatilho do Eventarc. Em geral, o local de um gatilho do Eventarc precisa corresponder ao local do recurso do Google Cloud que você quer monitorar para eventos. Na maioria dos cenários, você também precisa implantar o serviço na mesma região. Consulte Noções básicas sobre locais do Eventarc para mais detalhes sobre locais de acionador do Eventarc.
No campo Conta de serviço, selecione uma conta de serviço. Os gatilhos do Eventarc são vinculados a contas de serviço para usar como uma identidade ao invocar o serviço. A conta de serviço do gatilho do Eventarc precisa ter permissão para invocar o serviço. Por padrão, o Cloud Run usa a conta de serviço padrão do Compute Engine.
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. Por exemplo:
/,/route,routeeroute/subroute.Opcionalmente, para ativar novas tentativas se a tentativa de entrega falhar, marque a caixa de seleção Ativar nova tentativa em caso de falha. Caso contrário, o comportamento padrão será uma única tentativa de entrega sem novas tentativas. Para mais informações, consulte Eventos de repetição.
Depois de preencher os campos obrigatórios, clique em Salvar gatilho.
Depois de criar o gatilho, verifique a integridade garantindo que haja uma marca de seleção check_circle na guia Gatilhos.
gcloud
Implante o serviço do Cloud Run usando contêineres ou da origem.
Execute o comando a seguir para criar um gatilho que filtra e encaminha eventos:
gcloud eventarc triggers create TRIGGER_NAME \ --location=LOCATION \ --destination-run-service=DESTINATION_RUN_SERVICE \ --destination-run-region=DESTINATION_RUN_REGION \ --event-filters="type=EVENT_FILTER_TYPE" \ --max-retry-attempts=1 \ --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.comSubstitua:
TRIGGER_NAME: 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.Para evitar problemas de desempenho e residência de dados, o local precisa corresponder ao do serviço do Google Cloud que está gerando eventos. Saiba mais em Locais do Eventarc.
-
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) o local do Cloud Run 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. Um evento é gerado quando uma chamada de API para o método é bem-sucedida. Para operações de longa duração, o evento só é gerado no final da operação e apenas se a ação for realizada com êxito. Para conferir uma lista de tipos de evento compatíveis, consulte Tipos de evento do Google compatíveis com o Eventarc.SERVICE_ACCOUNT_NAME: o nome da conta de serviço gerenciada pelo usuário.PROJECT_ID: o ID do projeto Google Cloud .
Observações:
- A sinalização
--event-filters="type=EVENT_FILTER_TYPE"é obrigatória. Se nenhum outro filtro de evento for definido, a correspondência dos eventos de todos os recursos será feita. - Não é possível alterar
EVENT_FILTER_TYPEdepois da criação. Para mudarEVENT_FILTER_TYPE, crie um novo gatilho e exclua o antigo. - Cada gatilho pode ter vários filtros de eventos separados por vírgula em uma sinalização
--event-filters=[ATTRIBUTE=VALUE,...] ou repita a sinalização para adicionar mais filtros. Somente eventos que correspondam a todos os filtros são enviados para o destino. Caracteres curinga e expressões regulares não são compatíveis. No entanto, ao usar a sinalização--event-filters-path-pattern, é possível definir um padrão de caminho do recurso. - Como opção, para especificar uma única tentativa de entrega de evento sem novas tentativas, use a
flag
--max-retry-attempts. O único valor válido é1. Se você omitir a flag, o comportamento de repetição padrão será aplicado. Para mais informações, consulte Repetir eventos. - Outras sinalizações estão disponíveis. Para obter mais informações, consulte
gcloud eventarc triggers create.
Terraform
Para criar um gatilho do Eventarc para um serviço do Cloud Run, consulte Criar um gatilho usando o Terraform.
Criar um gatilho para funções
Depois de implantar uma função, é possível configurar um gatilho usando o console do Google Cloud , a Google Cloud CLI ou o Terraform.
Console
Ao usar o console do Google Cloud para criar uma função, também é possível adicionar um gatilho a ela. Siga estas etapas para criar um gatilho para sua função:
No console do Google Cloud , acesse o Cloud Run:
Clique em Escrever uma função e insira os detalhes da função. Para mais informações sobre como configurar funções durante a implantação, consulte Implantar funções.
Na seção Gatilho, clique em Adicionar gatilho.
Selecione uma opção.
No painel Gatilho do Eventarc, modifique os detalhes do gatilho da seguinte maneira:
No campo Nome do gatilho, digite um nome ou use o nome padrão.
Selecione um Tipo de acionador na lista:
Fontes do Google para especificar acionadores para Pub/Sub, Cloud Storage, Firestore, e outros provedores de eventos do Google.
Terceiros para integração com provedores que não são do Google que oferecem uma origem do Eventarc. Para mais informações, consulte Eventos de terceiros no Eventarc.
Selecione um provedor de eventos na lista Provedor de eventos para selecionar um produto que ofereça o tipo de evento para acionar sua função. Para ver a lista de provedores de eventos, consulte Provedores e destinos de eventos.
Selecione um tipo de evento na lista Tipo de evento. A configuração do gatilho varia de acordo com o tipo de evento compatível: Para mais informações, consulte Tipos de eventos.
Se o campo Região estiver ativado, selecione um local para o gatilho do Eventarc. Em geral, o local de um gatilho do Eventarc precisa corresponder ao local do recurso doGoogle Cloud que você quer monitorar para eventos. Na maioria dos cenários, você também precisa implantar a função na mesma região. Consulte Noções básicas sobre locais do Eventarc para mais detalhes sobre locais de acionador do Eventarc.
No campo Conta de serviço, selecione uma conta de serviço. Os acionadores do Eventarc são vinculados a contas de serviço para usar como uma identidade ao invocar a função. A conta de serviço do acionador do Eventarc precisa ter permissão para invocar a função. Por padrão, o Cloud Run usa a conta de serviço padrão do Compute Engine.
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. Por exemplo:
/,/route,routeeroute/subroute.Opcionalmente, para ativar novas tentativas se a tentativa de entrega falhar, marque a caixa de seleção Ativar nova tentativa em caso de falha. Caso contrário, o comportamento padrão será uma única tentativa de entrega sem novas tentativas. Para mais informações, consulte Eventos de repetição.
Depois de preencher os campos obrigatórios, clique em Salvar gatilho.
Clique em Criar.
Na guia Origem, edite o código-fonte, se necessário, e selecione Salvar e reimplantar.
gcloud
Ao criar uma função usando a CLI gcloud, primeiro é preciso implantar a função e, em seguida, criar um gatilho. Siga estas etapas para criar um gatilho para sua função:
Execute o seguinte comando no diretório que contém o exemplo de código para implantar a função:
gcloud run deploy FUNCTION \ --source . \ --function FUNCTION_ENTRYPOINT \ --base-image BASE_IMAGE_ID \ --region REGIONSubstitua:
FUNCTION: o nome da função que você está implantando. É possível omitir esse parâmetro inteiramente, mas será solicitado o nome, se você omiti-lo.FUNCTION_ENTRYPOINT: o ponto de entrada da função no código-fonte. Esse é o código que o Cloud Run executa quando é executada. O valor dessa sinalização precisa ser um nome de função ou de classe totalmente qualificada no código-fonte.BASE_IMAGE_ID: o ambiente de imagem de base da função. Para mais detalhes sobre as imagens de base e os pacotes incluídos em cada imagem, consulte Imagens de base dos ambientes de execução.REGION: a região do Google Cloud em que você quer implantar a função. Por exemplo,europe-west1.
Execute o comando a seguir para criar um gatilho que filtra e encaminha eventos:
gcloud eventarc triggers create TRIGGER_NAME \ --location=LOCATION \ --destination-run-service=FUNCTION \ --destination-run-region=DESTINATION_RUN_REGION \ --event-filters="type=EVENT_FILTER_TYPE" \ --max-retry-attempts=1 \ --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.comSubstitua:
TRIGGER_NAME: 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.Para evitar problemas de desempenho e residência de dados, o local precisa corresponder ao do serviço do Google Cloud que está gerando eventos. Saiba mais em Locais do Eventarc.
-
FUNCTION: o nome da função do Cloud Run implantada que recebe os eventos do gatilho. -
DESTINATION_RUN_REGION: (opcional) o local do Cloud Run em que a função do Cloud Run de destino pode ser encontrada. Se não especificado, presume-se que a função está na mesma região que o gatilho. EVENT_FILTER_TYPE: o identificador do evento. Um evento é gerado quando uma chamada de API para o método é bem-sucedida. Para operações de longa duração, o evento só é gerado no final da operação e apenas se a ação for realizada com êxito. Para conferir uma lista de tipos de evento compatíveis, consulte Tipos de evento do Google compatíveis com o Eventarc.SERVICE_ACCOUNT_NAME: o nome da conta de serviço gerenciada pelo usuário.PROJECT_ID: o ID do projeto Google Cloud .
Observações:
- A sinalização
--event-filters="type=EVENT_FILTER_TYPE"é obrigatória. Se nenhum outro filtro de evento for definido, a correspondência dos eventos de todos os recursos será feita. - Não é possível alterar
EVENT_FILTER_TYPEdepois da criação. Para mudarEVENT_FILTER_TYPE, crie um novo gatilho e exclua o antigo. - Cada gatilho pode ter vários filtros de eventos separados por vírgula em uma sinalização
--event-filters=[ATTRIBUTE=VALUE,...] ou repita a sinalização para adicionar mais filtros. Somente eventos que correspondam a todos os filtros são enviados para o destino. Caracteres curinga e expressões regulares não são compatíveis. No entanto, ao usar a sinalização--event-filters-path-pattern, é possível definir um padrão de caminho do recurso. - Como opção, para especificar uma única tentativa de entrega de evento sem novas tentativas, use a
flag
--max-retry-attempts. O único valor válido é1. Se você omitir a flag, o comportamento de repetição padrão será aplicado. Para mais informações, consulte Repetir eventos. - Outras sinalizações estão disponíveis. Para obter mais informações, consulte
gcloud eventarc triggers create.
Terraform
Para criar um gatilho do Eventarc para uma função do Cloud Run, consulte Criar um gatilho usando o Terraform.
Definir o prazo de confirmação do Pub/Sub
As funções do Cloud Run orientadas a eventos são implementadas usando o Eventarc
em combinação com uma assinatura do Pub/Sub. Por padrão, o
prazo de confirmação (ack)
dessa assinatura do Pub/Sub é de 10 segundos. Essa configuração é insuficiente
para muitas funções e pode causar execuções duplicadas
indesejadas.
Se você acionar o serviço ou a função diretamente com uma assinatura por push do Pub/Sub sem o Eventarc, as assinaturas por push direto vão compartilhar o mesmo padrão de 10 segundos e o prazo máximo de confirmação de 600 segundos (10 minutos), que limita o tempo limite da solicitação.
Recomendamos que você defina o prazo de ack para o serviço ou a função como
o valor máximo de 600 segundos, da seguinte maneira:
Console
Depois de implantar a função, siga estas etapas para modificar o prazo de ack da função:
No console do Google Cloud , acesse o Cloud Run:
Localize a função que você quer atualizar na lista de serviços e clique nela para abrir os detalhes.
Abra a guia Gatilhos.
Clique no nome do gatilho para abrir os Detalhes do gatilho.
Clique no link Topic para abrir o painel de edição de tópicos.
Clique no nome do ID da assinatura para acessar o painel de assinaturas e clique em Editar na parte de cima da página.
Defina o valor de Prazo de confirmação como 600 e clique em Atualizar para salvar a mudança.
gcloud
Atualize o prazo de ack por gatilho para o valor máximo de 600 segundos.
Os comandos a seguir fazem referência a variáveis (TRIGGER_NAME e
LOCATION) com valores que você definiu nas etapas anteriores.
## Per Cloud Run function: # Update Ack Deadline to max (600s) SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$TRIGGER_NAME" --location $LOCATION --format json | jq -r '.transport.pubsub.subscription') gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600
Faça uma atualização em massa em todos os gatilhos de serviço e função para definir os
prazos de ack como 600 segundos:
### Match all Cloud Run service triggers and update all deadlines to 600s (max timeout) ### This will change ALL Cloud Run services and Cloud Run functions TRIGGER_NAMES=($(gcloud eventarc triggers list | awk '/Cloud Run service/ {print $1}')) if [ ${#TRIGGER_NAMES[@]} -eq 0 ]; then echo "No matching triggers found" fi for trigger in "${TRIGGER_NAMES[@]}"; do echo "Updating ack deadline for trigger: $trigger" SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$trigger" --location $LOCATION --format json | jq -r '.transport.pubsub.subscription') if [ -z "$SUBSCRIPTION_ID" ]; then echo "Error: Could not retrieve subscription ID for trigger: $trigger" continue # Skip to the next trigger fi gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600 echo "Ack deadline updated for subscription: $SUBSCRIPTION_ID" done
Ver o ID e a origem do CloudEvent
Para conferir o ID e a origem do CloudEvent que acionou o serviço, consulte os seguintes recursos nos registros de serviço do Cloud Run:
LogEntry.labels.run.googleapis.com/cloud_event_idLogEntry.labels.run.googleapis.com/cloud_event_source
A seguir
- Provedores e destinos de eventos
- Tipos de eventos do Google compatíveis com o Eventarc
- Tentar novamente eventos no Eventarc
- Preços do Eventarc