Crea arquitecturas controladas por eventos con Eventarc
Puedes usar Eventarc y Firestore para compilar arquitecturas orientadas a eventos. Activadores de Firestore para Eventarc genera eventos a partir de cambios a documentos particulares de tu base de datos. El activador puede enrutar eventos a un destino admitido:
- Funciones de Cloud Run (2ª gen..), que son compatibles con las bibliotecas cliente de Cloud y el SDK de Firebase
- Cloud Run
- Google Kubernetes Engine
- Workflows
Eventarc ofrece una solución estandarizada para administrar el flujo de cambios de estado, llamados eventos, entre microservicios separados. Cuando se activa, Eventarc enruta estos eventos en varios destinos y, al mismo tiempo, administrar la entrega, la seguridad, la autorización la observabilidad y el manejo de errores.
Limitaciones
Ten en cuenta las siguientes limitaciones de los activadores de Firestore para Eventarc:
- No se garantiza el ordenamiento. Los cambios rápidos pueden activar eventos en un orden inesperado.
Los eventos se entregan al menos una vez.
Asegúrate de que tu controlador de eventos sea idempotente y evita producir resultados inesperados o efectos secundarios cuando un evento se publica más de una vez. Consulta Compila funciones idempotentes para obtener más información.
Un activador se asocia con una sola base de datos. No puedes crear un activador que coincida con varias bases de datos.
Cuando se borra una base de datos, no se borra automáticamente ningún activador de la base de datos. El activador deja de entregar eventos, pero sigue existiendo hasta que lo borras.
Ubicaciones de Eventarc y Firestore
Eventarc no es compatible con multirregiones para eventos de Firestore pero aún puedes crear activadores para las bases de datos de Firestore en ubicaciones multirregionales. Eventarc asigna Firestore ubicaciones multirregionales a las siguientes regiones de Eventarc:
Firestore multirregional | Región de Eventarc |
---|---|
nam5 |
us-central1 |
eur3 |
europe-west4 |
Diferencias entre las funciones de Cloud Run (2ª gen.. y 1a gen.)
Las funciones de Cloud Run (2ª gen.) usan eventos de Eventarc para todos los entornos de ejecución. Anteriormente, las funciones de Cloud Run (1ª gen.) usaban eventos de Eventarc para solo algunos entornos de ejecución. Los eventos de Eventarc presentan las siguientes diferencias de Funciones de Cloud Run (1a gen.).
Los activadores de Firestore para la compatibilidad con Eventarc destinos adicionales además de las funciones de Cloud Run. Puedes enrutar
CloudEvents
a varios destinos, entre ellos, entre otras, Cloud Run, GKE y WorkflowsLos activadores de Firestore para Eventarc recuperan el definición de activador al inicio de una operación de escritura de la base de datos y usa esa definición para decidir si Firestore debe emitir un evento. La operación de escritura no tiene en cuenta ningún cambio en la definición del activador que pueda ocurrir mientras se ejecuta.
Cloud Run Functions (1a gen.) recupera la definición del activador durante el evaluación de la escritura de la base de datos y los cambios en el activador durante puede afectar si Firestore emite un evento o no.
Interoperabilidad de eventos en modo Datastore y modo nativo
Eventarc admite activadores de eventos para el modo Datastore y el código nativo . Estos activadores de eventos son interoperables con ambos tipos de bases de datos. Una base de datos de Firestore en modo nativo puede recibir Datastore eventos, y una base de datos de Firestore en modo Datastore puede recibir Eventos de modo nativo.
La interoperabilidad de eventos te permite compartir el código de Eventarc en Bases de datos de Firestore de distintos tipos.
Conversiones de eventos
Si aplicas un activador de eventos de modo nativo a un Datastore de Compute Engine, Eventarc realiza las siguientes conversiones:
- El espacio de nombres de la entidad se almacena en el atributo
PartitionId
del evento. - Las entidades incorporadas se convierten a los tipos
map
de modo nativo.
¿Qué sigue?
- Obtén más información sobre las arquitecturas controladas por eventos.