Sie können einen Eventarc-Trigger verwenden, um einen Workflow als Reaktion auf ein Ereignis oder eine Reihe von Ereignissen auszuführen. Die Ereignisse werden von einem Ereignisanbieter an interessierte Ereignisempfänger weitergeleitet.
Eventarc liefert Ereignisse über eine HTTP-Anfrage an den Ereignisempfänger im CloudEvents-Format. Der Workflows-Dienst konvertiert das Ereignis in ein JSON-Objekt (gemäß der CloudEvents-Spezifikation) und übergibt das Ereignis als Workflow-Laufzeitargument an die Workflow-Ausführung.
Die Ausführung Ihres Workflows wird ausgelöst:
- Wenn ein Audit-Log erstellt wird, das den Filterkriterien des Triggers entspricht. Ein Beispiel finden Sie in dieser Kurzanleitung, in der Sie Workflows mit Ereignissen aus BigQuery mithilfe von Cloud-Audit-Logs auslösen.
- Als Reaktion auf direkte Ereignisse, z. B. eine Aktualisierung eines Cloud Storage-Buckets oder eine Aktualisierung einer Firebase Remote Config-Vorlage. Ein Beispiel finden Sie in dieser Kurzanleitung, in der Sie Workflows mit direkten Ereignissen aus Cloud Storage auslösen.
- Nach Nachrichten, die in einem Pub/Sub-Thema veröffentlicht wurden. In dieser Kurzanleitung wird beispielsweise beschrieben, wie Sie Workflows mit Pub/Sub-Nachrichten auslösen.
Wichtige Hinweise:
Ereignisse gelten als zugestellt, sobald die Workflowausführung beginnt. Die eigentliche Ausführung erfolgt asynchron in den Workflows-Diensten.
Ausführungen, die durch Ereignisse ausgelöst werden, werden nicht wiederholt, wenn die Workflowausführung beginnt, aber später fehlschlägt. Weitere Informationen finden Sie unter Wiederholungsrichtlinie für Ereignisse.
Das Deduplizierungsfenster für Workflows, um eine genaue Verarbeitung von Ereignissen zu gewährleisten, beträgt 24 Stunden.
Wenn Sie Workflows als Ziel für einen Eventarc-Trigger verwenden, lösen Ereignisse, die größer als die maximale Argumentgröße von Workflows sind, keine Workflow-Ausführungen aus. Weitere Informationen finden Sie unter Kontingente und Limits.
Wenn Sie in Projekten, die durch einen Dienstperimeter geschützt sind, Ereignisse an Workflows-Ziele weiterleiten, für die der Pub/Sub-Push-Endpunkt auf eine Workflows-Ausführung festgelegt ist, können Sie neue Pub/Sub-Push-Abos nur über Eventarc erstellen. Das Dienstkonto, das für die Push-Authentifizierung für den Workflows-Endpunkt verwendet wird, muss im Dienstperimeter enthalten sein. Weitere Informationen finden Sie unter Dienstperimeter mit VPC Service Controls einrichten.
Trigger mit der Google Cloud-Befehlszeile erstellen
Wenn Sie einen gcloud eventarc triggers create-Befehl zusammen mit den erforderlichen und optionalen Flags ausführen, können Sie einen Trigger erstellen.
Weitere Informationen finden Sie in der gcloud-Anleitung im Abschnitt „Trigger erstellen“, wenn Sie einen Trigger für einen bestimmten Anbieter, Ereignistyp und ein bestimmtes Workflows-Ziel erstellen.
Trigger mit der Konsole erstellen
In den folgenden Schritten wird beschrieben, wie Sie auf der Seite Workflows in der Google Cloud -Konsole einen Trigger erstellen.
Hinweis
-
Aktivieren Sie die Eventarc- und Pub/Sub APIs.
Rollen, die zum Aktivieren von APIs erforderlich sind