Eventarc-Trigger konfigurieren

Auf dieser Seite wird beschrieben, wie Sie einen Eventarc-Trigger in Application Integration konfigurieren.

Mit einem Eventarc-Trigger können Sie Integrationen basierend auf Ereignissen ausführen, die über Eventarc Standard weitergeleitet werden. Mit einem Eventarc-Trigger können Sie Integrationsflows erstellen, die durch Ereignisse aus verschiedenen Google Cloud -Diensten, Drittanbieterdiensten und benutzerdefinierten Ereignisquellen ausgelöst werden. Sie können den Trigger beispielsweise verwenden, um eine Integration zu starten, wenn ein neues Objekt in einen Cloud Storage-Bucket hochgeladen wird.

In der Google Cloud Console können Sie einen Eventarc-Trigger auf folgende Arten erstellen und konfigurieren:

Hinweis

Bevor Sie den Eventarc-Trigger konfigurieren, aktivieren Sie die Eventarc API und die Pub/Sub API:

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

APIs aktivieren

Hinweise

Beachten Sie beim Konfigurieren eines Eventarc-Triggers Folgendes:

  • Wenn beim Veröffentlichen der Integration aufgrund von Konfigurationsfehlern kein Eventarc-Trigger erstellt werden kann, wird die Integration trotzdem veröffentlicht, der Trigger ist jedoch nicht aktiv.

    Heben Sie die Veröffentlichung der Integration auf, überprüfen und korrigieren Sie die Konfiguration des Eventarc-Triggers sorgfältig und veröffentlichen Sie die Integration dann noch einmal. Sie können den Status der Erstellung des Eventarc-Triggers prüfen, indem Sie in der Google Cloud Console-Symbolleiste auf  (Benachrichtigung) klicken.

  • Wenn Sie eine neue Version Ihrer Integration mit einer geänderten Eventarc-Triggerkonfiguration veröffentlichen, wird der alte Trigger automatisch durch einen neuen ersetzt. So wird sichergestellt, dass Ihre Integration immer die aktuelle Triggerkonfiguration verwendet und alle veralteten Trigger gelöscht werden.
  • Wenn Sie eine neue Version Ihrer Integration veröffentlichen und denselben Eventarc-Trigger und seine Konfiguration verwenden, wird kein neuer Trigger erstellt. Stattdessen wird der vorhandene Eventarc-Trigger für die neue Integrationsversion wiederverwendet.

Eventarc-Trigger über Application Integration erstellen

So erstellen Sie einen Eventarc-Trigger über Application Integration:

  1. Eventarc-Trigger in Application Integration hinzufügen
  2. Eventarc-Trigger im Integrationseditor konfigurieren

Eventarc-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um Ihrer Integration einen Eventarc-Trigger hinzuzufügen:

  1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

    Zu „Application Integration“

  2. Klicken Sie im Navigationsmenü auf Integrationen.

    Die Seite Integrationsliste wird angezeigt und enthält alle Integrationen, die im Google Cloud-Projekt verfügbar sind.

  3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus.
    3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für die Integration ändern oder aktualisieren.
    4. Klicken Sie auf Erstellen.

    Die neu erstellte Integration wird im Integrationseditor geöffnet.

  4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
  5. Ziehen Sie das Element Eventarc per Drag-and-drop in den Integrationseditor.

Eventarc-Trigger konfigurieren

Klicken Sie im Integrationseditor auf das Element Eventarc-Trigger, um einen Eventarc-Trigger zu konfigurieren. Der Konfigurationsbereich Eventarc-Trigger wird mit den folgenden Feldern angezeigt:

  • Label (optional): Der sichtbare Name des Eventarc-Triggers in Ihrer Integration. Sie können das Label in einen beliebigen Namen ändern.
  • Hinweise (optional): Sie können Hinweise hinzufügen, um zusätzliche Informationen zum Trigger bereitzustellen.
  • Klicken Sie auf Eventarc-Trigger konfigurieren und geben Sie die folgenden Eingaben im Eventarc-Trigger-Editor an:
    • Triggername: Geben Sie einen Namen für den Trigger ein.
    • Triggertyp: Wählen Sie einen der folgenden Triggertypen aus:
      • Google-Quelle: Wählen Sie diese Option aus, um einen Trigger für Pub/Sub, Cloud Storage, Firestore und andere Google-Ereignisanbieter zu erstellen.
      • Benutzerdefiniert: Wählen Sie diese Option aus, um einen Trigger für eine benutzerdefinierte Ereignisquelle zu erstellen.
      • Drittanbieter: Wählen Sie diese Option aus, um einen Trigger für Nicht-Google-Anbieter zu erstellen, die eine Eventarc-Quelle anbieten. Weitere Informationen finden Sie unter Drittanbieterereignisse in Eventarc.
    • Ereignisanbieter: Wählen Sie den Ereignisanbieter für den Trigger aus. Die Liste der Ereignisanbieter hängt vom Triggertyp ab. Weitere Informationen finden Sie unter Ereignisanbieter und -ziele.
    • Ereignistyp: Wählen Sie den Ereignistyp für den Trigger aus. Die Triggerkonfiguration variiert je nach ausgewähltem Ereignisanbieter. Weitere Informationen finden Sie unter Ereignistypen.
    • Region: Wählen Sie die Region für den Trigger aus.
    • Filter: Optional können Sie Filter hinzufügen, um die APIs auszuwählen, die Ihren Kriterien entsprechen. Wenn Sie die APIs beispielsweise nach einem bestimmten Namen filtern, wird das Ereignis nur ausgelöst, wenn die APIs, die den Filterkriterien entsprechen, aktualisiert werden.
    • Dienstkonto: Wählen Sie das Dienstkonto aus, das für den Trigger verwendet werden soll. Wenn Sie kein Dienstkonto auswählen, verwendet der Trigger das Compute Engine-Standarddienstkonto als Identität, wenn er Ihren Dienst aufruft. Das mit dem Trigger verknüpfte Dienstkonto muss die erforderlichen Berechtigungen zum Aufrufen Ihres Dienstes haben.

    • Bei Fehler noch einmal versuchen: Wählen Sie diese Option aus, um Trigger-Wiederholungsversuche zu aktivieren, wenn das Ziel das Ereignis nicht verarbeiten kann.
    • Netzwerkanhang: Wählen Sie den Netzwerkanhang aus, der für den Trigger verwendet werden soll. Diese Liste wird basierend auf den in Ihrem Projekt erstellten Netzwerkverbindungen generiert.

      Netzwerkanhänge erleichtern die Kommunikation zwischen VPC-Netzwerken (Virtual Private Cloud) von Diensterstellern und Nutzer-VPC-Netzwerken. Eventarc verwendet den konfigurierten Netzwerkanhang, um eine Verbindung zu einem internen HTTP-Endpunkt herzustellen, der im VPC-Netzwerk des Nutzers gehostet wird, und so Ereignisdaten zu übertragen. Weitere Informationen zum Erstellen und Verwalten von Netzwerkanhängen finden Sie unter Netzwerkanhänge erstellen und verwalten.

  • Klicken Sie auf Trigger speichern, um die Triggerkonfiguration zu speichern.

Eventarc-Trigger über die Eventarc-Konsole erstellen

So erstellen Sie einen Eventarc-Trigger über die Eventarc Console-Seite:

  1. Rufen Sie in der Google Cloud Console die Seite Eventarc > Trigger auf.

    Zur Seite "Trigger"

    Auf der Seite Trigger werden alle Trigger in Ihrem Projekt aufgeführt.

  2. Klicken Sie auf Trigger erstellen.
  3. Geben Sie auf der Seite Trigger erstellen die folgenden Informationen ein:
    1. Triggername: Geben Sie einen Namen für den Trigger ein.
    2. Triggertyp: Wählen Sie einen der folgenden Triggertypen aus:
      • Google-Quellen: Wählen Sie diese Option aus, um einen Trigger für Pub/Sub, Cloud Storage, Firestore und andere Google-Ereignisanbieter zu erstellen.
      • Benutzerdefiniert: Wählen Sie diese Option aus, um einen Trigger für eine benutzerdefinierte Ereignisquelle zu erstellen.
      • Drittanbieter: Wählen Sie diese Option aus, um einen Trigger für Nicht-Google-Anbieter zu erstellen, die eine Eventarc-Quelle anbieten. Weitere Informationen finden Sie unter Drittanbieterereignisse in Eventarc.
    3. Ereignisanbieter: Wählen Sie den Ereignisanbieter für den Trigger aus. Die Liste der Ereignisanbieter hängt vom Triggertyp ab. Weitere Informationen finden Sie unter Ereignisanbieter und -ziele.
    4. Ereignistyp: Wählen Sie den Ereignistyp für den Trigger aus. Die Triggerkonfiguration variiert je nach ausgewähltem Ereignisanbieter. Weitere Informationen finden Sie unter Ereignistypen.
    5. Inhaltstyp der Ereignisdaten: Wählen Sie den Datentyp für den Ereignisinhalt aus. Wählen Sie entweder application/json oder application/protobuf aus.
    6. Region: Wählen Sie die Region für den Trigger aus.
    7. Dienstkonto: Wählen Sie das Dienstkonto aus, das für den Trigger verwendet werden soll. Wenn Sie kein Dienstkonto auswählen, verwendet der Trigger das Compute Engine-Standarddienstkonto als Identität, wenn er Ihren Dienst aufruft. Das mit dem Trigger verknüpfte Dienstkonto muss die erforderlichen Berechtigungen zum Aufrufen Ihres Dienstes haben.
    8. Event-Ziel: Wählen Sie Application Integration (App-Integration) aus.
    9. Integration auswählen: Wählen Sie die Integration aus, für die Sie den Trigger erstellen möchten. Wenn die Integration veröffentlicht ist, erstellt Application Integration eine neue Entwurfsversion der Integration, der der Eventarc-Trigger hinzugefügt wird.
    10. Netzwerkanhang: Wählen Sie den Netzwerkanhang aus, der für den Trigger verwendet werden soll. Diese Liste wird basierend auf den in Ihrem Projekt erstellten Netzwerkverbindungen generiert.

      Netzwerkanhänge erleichtern die Kommunikation zwischen VPC-Netzwerken (Virtual Private Cloud) von Diensterstellern und Nutzer-VPC-Netzwerken. Eventarc verwendet den konfigurierten Netzwerkanhang, um eine Verbindung zu einem internen HTTP-Endpunkt herzustellen, der im VPC-Netzwerk des Nutzers gehostet wird, und so Ereignisdaten zu übertragen. Weitere Informationen zu Netzwerkanhängen finden Sie unter Netzwerkanhänge.

  4. Klicken Sie auf Integration öffnen.

    Die Seite „Application Integration Editor“ wird geöffnet. Die Integration ist ausgewählt und das neue Element Eventarc-Trigger wurde der Integration hinzugefügt.

  5. Klicken Sie auf das Element Eventarc-Trigger und öffnen Sie den Bereich für die Triggerkonfiguration.
  6. Prüfen Sie die Triggerkonfiguration auf der Seite Eventarc-Trigger-Editor.
  7. Verbinden Sie den neuen Eventarc-Trigger mit Ihrem Integrationsablauf und veröffentlichen Sie die Integration.