Criar arquiteturas orientadas a eventos com o Eventarc
Você pode usar o Eventarc e Firestore para criação orientadas por eventos. Gatilhos do Firestore para O Eventarc gera eventos com base em mudanças a documentos específicos no banco de dados. O gatilho pode rotear eventos para um destino compatível:
- Funções do Cloud Run (2a geração) com suporte às bibliotecas de cliente do Cloud e ao SDK do Firebase
- Cloud Run
- Google Kubernetes Engine
- Workflows
O Eventarc oferece uma solução padronizada para gerenciar o fluxo de mudanças de estado, chamadas de eventos, entre microsserviços separados. Quando ele é acionado, O Eventarc encaminha esses eventos para vários destinos, gerenciando a entrega, a segurança, a autorização observabilidade e tratamento de erros.
Limitações
Observe as seguintes limitações para gatilhos do Firestore para Eventarc:
- Não garantimos acionamentos em ordem. Alterações rápidas podem acionar eventos em uma ordem inesperada.
Os eventos são entregues pelo menos uma vez.
Verifique se o manipulador de eventos é idempotente e evite produzir resultados inesperados ou efeitos colaterais quando um evento é exibido mais de uma vez. Consulte Como criar funções idempotentes para saber mais.
Um gatilho está associado a um único banco de dados. Não é possível criar um gatilho que corresponda a vários bancos de dados.
A exclusão de um banco de dados não remove automaticamente nenhum gatilho dele. O gatilho deixa de entregar eventos, mas continua existindo até que você o exclua.
Locais do Eventarc e do Firestore
O Eventarc não oferece suporte a multirregiões para o evento do Firestore mas ainda é possível criar gatilhos para bancos de dados do Firestore em locais multirregionais. Mapas do Eventarc no Firestore locais multirregionais para as seguintes regiões do Eventarc:
Multirregião do Firestore | Região do Eventarc |
---|---|
nam5 |
us-central1 |
eur3 |
europe-west4 |
Diferenças entre as funções do Cloud Run de 2a e 1a geração
As funções do Cloud Run (2a geração) usam eventos do Eventarc para todos os ambientes de execução. Antes, as funções do Cloud Run (1a geração) usavam eventos Eventarc para apenas alguns ambientes de execução. Os eventos do Eventarc apresentam as seguintes diferenças em Funções do Cloud Run (1a geração).
Os gatilhos do Firestore para suporte ao Eventarc destinos adicionais além das funções do Cloud Run. Você pode encaminhar
CloudEvents
a vários destinos, como mas não se limitando ao Cloud Run, GKE e Workflows.Os gatilhos do Firestore para Eventarc recuperam a de gatilho no início de uma operação de gravação no banco de dados e usa essa definição para decidir se o Firestore deve emitir um evento. O gravação não considera as alterações na definição de acionamento que pode acontecer enquanto ele é executado.
As funções do Cloud Run (1a geração) recuperam a definição do gatilho durante a da gravação no banco de dados e alterações no gatilho durante pode afetar a emissão de um evento pelo Firestore.
Interoperabilidade de eventos no modo Datastore e no modo nativo
O Eventarc oferece suporte a gatilhos de eventos para o modo Datastore e nativo modo Esses gatilhos de evento são interoperáveis com os dois tipos de banco de dados. Um Firestore no banco de dados no modo nativo pode receber dados do Datastore eventos, e um banco de dados do Firestore no modo Datastore pode receber Eventos do modo nativo.
A interoperabilidade de eventos permite compartilhar o código do Eventarc Bancos de dados do Firestore de diferentes tipos.
Conversões de eventos
Se você aplicar um gatilho de evento do modo nativo a um Datastore no modo de banco de dados, o Eventarc faz as seguintes conversões:
- O namespace da entidade é armazenado no atributo
PartitionId
do evento. - As entidades incorporadas são convertidas em tipos
map
do modo nativo.
A seguir
- Saiba mais sobre arquiteturas orientadas a eventos.