Ereignisgesteuerte Architekturen mit Eventarc erstellen

Mit Eventarc und Firestore können Sie ereignisgesteuerte Architekturen erstellen. Firestore-Trigger für Eventarc generieren Ereignisse aus Änderungen an einem bestimmten Dokument in Ihrer Datenbank. Der Trigger kann Ereignisse an ein unterstütztes Ziel weiterleiten:

Eventarc bietet eine standardisierte Lösung, um den Ablauf der Statusänderungen, die sogenannten Ereignisse, zwischen entkoppelten Mikrodiensten zu verwalten. Bei Auslösung leitet Eventarc diese Ereignisse an verschiedene Ziele weiter und verwaltet dabei die Bereitstellung, Sicherheit, Autorisierung, Beobachtbarkeit und Fehlerbehandlung.

Beschränkungen

Beachten Sie die folgenden Einschränkungen für Firestore-Trigger für Eventarc:

  • Die Reihenfolge ist nicht garantiert. Schnelle Änderungen können Ereignisse in einer unvorhergesehenen Reihenfolge auslösen.

  • Ereignisse werden mindestens einmal übermittelt.

    Achten Sie darauf, dass Ihr Event-Handler idempotent ist, und vermeiden Sie unerwartete Ergebnisse oder Nebeneffekte, wenn ein Ereignis mehrmals bereitgestellt wird. Weitere Informationen finden Sie unter Idempotente Funktionen erstellen.

  • Ein Trigger ist mit einer einzelnen Datenbank verknüpft. Sie können keinen Trigger erstellen, der mit mehreren Datenbanken übereinstimmt.

  • Wenn Sie eine Datenbank löschen, werden keine Trigger für diese Datenbank automatisch gelöscht. Der Trigger sendet keine Ereignisse mehr, bleibt aber bestehen, bis Sie ihn löschen. Wenn die Datenbank neu erstellt wird, müssen alle zugehörigen Trigger ebenfalls gelöscht und neu erstellt werden, um die Ereignisübermittlung wiederherzustellen.

Eventarc- und Firestore-Standorte

Eventarc unterstützt keine Multi-Regionen für Firestore-Ereignistrigger im nativen Modus. Sie können aber weiterhin Trigger für Firestore-Datenbanken an Standorten mit mehreren Regionen erstellen. Eventarc ordnet Firestore-Mehrfachregionsstandorte den folgenden Eventarc-Regionen zu:

Firestore multiregional Eventarc-Region
nam5 us-central1
eur3 europe-west4

Unterschiede zwischen Cloud Run-Funktionen der 2. und 1. Generation

Cloud Run-Funktionen (2. Generation) verwenden Eventarc-Ereignisse für alle Laufzeiten. Bisher wurden in Cloud Run-Funktionen (1. Generation) Eventarc-Ereignisse nur für einige Laufzeiten verwendet. Eventarc-Ereignisse weisen die folgenden Unterschiede zu Cloud Run-Funktionen (1. Generation) auf.

  • Die Firestore-Trigger für Eventarc unterstützen neben Cloud Run-Funktionen auch zusätzliche Ziele. Sie können CloudEvents an eine Reihe von Zielen weiterleiten, darunter Cloud Run, GKE und Workflows.

  • Firestore-Trigger für Eventarc rufen die Triggerdefinition zu Beginn eines Datenbankschreibvorgangs ab und verwenden diese Definition, um zu entscheiden, ob Firestore ein Ereignis ausgeben soll. Bei der Schreiboperation werden keine Änderungen an der Triggerdefinition berücksichtigt, die während der Ausführung auftreten.

    Cloud Run Functions (1. Generation) ruft die Triggerdefinition während der Auswertung des Datenbankschreibvorgangs ab. Änderungen am Trigger während der Auswertung können sich darauf auswirken, ob Firestore ein Ereignis ausgibt oder nicht.

Interoperabilität von Ereignissen im Datastore-Modus und im nativen Modus

Eventarc unterstützt Ereignistrigger sowohl für den Datastore-Modus als auch für den nativen Modus. Diese Ereignistrigger sind mit beiden Datenbanktypen kompatibel. Eine Firestore-Datenbank im nativen Modus kann Datastore-Ereignisse empfangen und eine Firestore-Datenbank im Datastore-Modus kann Ereignisse im nativen Modus empfangen.

Mit der Ereignisinteroperabilität können Sie Eventarc-Code für verschiedene Arten von Firestore-Datenbanken freigeben.

Event-Conversions

Wenn Sie einen Ereignistrigger im nativen Modus auf eine Datenbank im Datastore-Modus anwenden, führt Eventarc die folgenden Konvertierungen durch:

  • Der Namespace der Entität wird im Attribut PartitionId des Ereignisses gespeichert.
  • Eingebettete Entitäten werden in map-Typen im nativen Modus konvertiert.

Nächste Schritte