Informationen zu den unterstützten Connectors für Application Integration.

Cloud Pub/Sub-Trigger

Mit dem Cloud Pub/Sub-Trigger können Sie Ihre Integration basierend auf den Ereignissen in Ihrer Pub/Sub-Middleware ausführen.

Mit diesem Trigger können Sie eine Integration ausführen, wenn ein Publisher eine Nachricht an das von Ihnen gewählte Thema schreibt. Das Thema kann sich im selben Google Cloud Projekt wie die Integration oder in einem anderen Google Cloud Projekt befinden. Wenn dieser Trigger ausgeführt wird, schreibt er auch die veröffentlichte Nachricht in die Ausgabevariable CloudPubSubMessage. Sie können diese Variable basierend auf Ihren Anforderungen in Ihren nachgelagerten Triggern oder Aufgaben verwenden.

Informationen zum Erstellen einer Beispielintegration mit Application Integration und dem Cloud Pub/Sub-Trigger finden Sie unter Cloud Pub/Sub-Thema überwachen und E-Mail senden.

Hinweise

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud Projekt aus, bevor Sie den Cloud Pub/Sub-Trigger konfigurieren.

  • Weisen Sie dem Nutzer, der diesen Trigger erstellt, die Rolle Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin) zu.
  • Aktivieren Sie die Pub/Sub API für das Google Cloud Projekt, in dem sich Ihre Integration befindet.

    • Wenn die Pub/Sub API durch einen Dienstperimeter geschützt ist, müssen Sie die folgenden IAM-Rollen definieren, um diese Dienstperimeter zu verwalten:

    • Access Context Manager-Administrator (roles/accesscontextmanager.policyAdmin)
    • Access Context Manager-Bearbeiter (roles/accesscontextmanager.policyEditor)
    • Access Context Manager-Leser (roles/accesscontextmanager.policyReader)

  • Prüfen Sie, ob ein Pub/Sub-Thema vorhanden ist. So erstellen Sie ein neues Pub/Sub-Thema:
    1. Rufen Sie in der Cloud Console die Seite "Pub/Sub-Themen" auf.

      Zur Seite "Pub/Sub-Themen"

    2. Klicken Sie auf Thema erstellen.
    3. Geben Sie im Feld Themen-ID einen eindeutigen Themennamen ein.
    4. Klicken Sie auf Speichern.
Weitere Informationen zur Zugriffsverwaltung mit IAM-Rollen finden Sie unter Zugriffssteuerung.

Informationen zum Zuweisen von Rollen für Hauptkonten finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.

Cloud Pub/Sub-Trigger hinzufügen

So fügen Sie einen Cloud Pub/Sub-Trigger zu einer neuen oder vorhandenen Integration hinzu:
  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 Liste der Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, 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 Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ä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 eine Liste der verfügbaren Trigger aufzurufen.
  5. Klicken Sie auf das Element Cloud Pub/Sub-Trigger und platzieren Sie es im Designer.

Cloud Pub/Sub-Trigger konfigurieren

Klicken Sie im Integrationseditor auf das Element Cloud Pub/Sub-Trigger, um den Trigger-Konfigurationsbereich aufzurufen. Führen Sie dann die folgenden Schritte aus:

  1. Geben Sie im Feld Pub/Sub-Thema das Thema, das der Trigger überwachen soll, in folgendem Format an: 
    projects/PROJECT_ID/topics/TOPIC_ID

    Alle verfügbaren Themen in Ihrem Google Cloud Projekt finden Sie in der Spalte Themenname unter Themen. Sie können auch ein Thema aus einem anderen Projekt auswählen. Google Cloud

    Ersetzen Sie Folgendes:
    • PROJECT_ID: das Google Cloud Projekt, in dem das Thema erstellt wurde.
    • TOPIC_ID: die ID Ihres Pub/Sub-Themas. Das Thema kann sich im Google Cloud selben Projekt wie das Ihrer Integration oder in einem anderen Projekt Google Cloud befinden.
  2. Wählen Sie das Dienstkonto aus, mit dem Sie die Integration aufrufen möchten. Sie können auch eine Konfigurationsvariable auswählen, die Sie in der Integration erstellt haben. Der Wert der Variablen „config“ muss eine E-Mail-Adresse eines Dienstkontos im folgenden Format sein: SERVICE_ACCOUNT_NAME@project-id.iam.gserviceaccount.com. Beispiel: application-integration-invoke@project123.iam.gserviceaccount.com

    Informationen zum Erstellen einer Konfigurationsvariablen finden Sie unter Variable erstellen. Informationen zum Erstellen eines Dienstkontos finden Sie unter Dienstkonto erstellen.

    Wenn Sie eine Konfigurationsvariable auswählen, müssen Sie dem Dienstkonto, auf das die Konfigurationsvariable verweist, die erforderlichen Rollen zuweisen. Weitere Informationen zum Gewähren von Rollen finden Sie unter Erforderliche IAM-Rollen.

    Wenn keine Dienstkonten vorhanden sind, erstellen Sie ein Dienstkonto. Klicken Sie dazu in der Liste Dienstkonto auf Neu erstellen.

Standardmäßig ist die Option für den Ablaufzeitraum für Abos auf never expire festgelegt. Wenn Sie das Ablaufdatum auf einen anderen Wert festlegen möchten, rufen Sie in der Google Cloud Console die Seite Pub/Sub-Abos auf und bearbeiten Sie das Abo.

Für Dienstkonten erforderliche IAM-Rollen

Wenn Sie bei der Auswahl eines Dienstkontos auf Zuweisen klicken, werden den verschiedenen Dienstkonten automatisch die folgenden Rollen zugewiesen.

Dienstkonto IAM-Rolle gewährt
Standarddienstkonto der Anwendungsintegration: service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com
  • Pub/Sub-Bearbeiter (roles/pubsub.editor)
  • Dienstkontonutzer (roles/iam.serviceAccountUser)

Wenn sich das Google Cloud Projekt des Pub/Sub-Themas vom Google CloudProjekt der Integration unterscheidet, benötigt das Standarddienstkonto die Rolle „Pub/Sub-Bearbeiter“ im Google Cloud Projekt des Themas.

Das Dienstkonto, das Sie für diesen Trigger auswählen Application Integration Invoker (roles/integrations.integrationInvoker)

Trigger-Ausgabe

Für jedes Ereignis generiert der Cloud Pub/Sub-Trigger eine CloudPubSubMessage-Ausgabevariable, die Sie in nachgelagerten Aufgaben verwenden können. Die Variable hat das JSON-Format und die Struktur PubsubMessage.

Abo mit Filter für Ihre Integration erstellen

Wenn Sie einen Filter für das Pub/Sub-Abo festlegen möchten, um bestimmte Ereignisse in Ihrer Integration zu verarbeiten, gehen Sie so vor:

  1. Veröffentlichen Sie die Integration mit dem konfigurierten Cloud Pub/Sub-Trigger. In diesem Schritt wird das Abo im Integrationsprojekt erstellt.
  2. Rufen Sie in der Google Cloud Console die Seite Abos auf.

    Zu den Abos

  3. Öffnen Sie das Abo und kopieren Sie alle Details, einschließlich des Abonamens.
  4. Löschen Sie das vorhandene Abo.
  5. Erstellen Sie ein neues Abo mit allen Details des gelöschten Abos, einschließlich des Abonamens, den Sie in Schritt 3 kopiert haben, und fügen Sie dem neuen Abo einen Filter hinzu.

    Das neu erstellte Abo löst die Integration mit gefilterten Nachrichten aus.

SLA-Ausschlüsse

Der Cloud Pub/Sub-Trigger hängt vom Pub/Sub-Produkt ab. Da diese Abhängigkeit extern zur Anwendungsintegration ist, gelten die Nutzungsbedingungen des Service Level Agreements (SLA) für die Anwendungsintegration nur, wenn der Cloud Pub/Sub-Trigger die Ausführung einer active-Integration erfolgreich startet.

Pub/Sub-Trigger mit VPC Service Controls verwenden

Wenn Sie einen Pub/Sub-Trigger in der Anwendungsintegration konfigurieren und versuchen, die Integration zu veröffentlichen, schlägt das Erstellen des erforderlichen Pub/Sub-Abos fehl, wenn die Pub/Sub API in VPC Service Controls durch einen Dienstperimeter geschützt ist.

Dienstperimeter erzwingen Sicherheitsgrenzen um Ihre Google Cloud -Ressourcen. Diese Richtlinien können verhindern, dass die Anwendungsintegration beim Veröffentlichen der Integration das erforderliche Pub/Sub-Abo erstellt.

So konfigurieren und veröffentlichen Sie einen Pub/Sub-Trigger in diesen Szenarien:

  1. Entfernen Sie die Pub/Sub API vorübergehend aus dem Dienstperimeter:
    1. Rufen Sie in der Google Cloud -Console die Seite VPC Service Controls auf.

      Zu „VPC Service Controls“

    2. Wählen Sie das Google Cloud Projekt aus, das das Pub/Sub-Thema enthält, das in der Integration verwendet werden soll.
    3. Optional: Wenn für das ausgewählte Projekt keine Zugriffsrichtlinie konfiguriert ist, wird die Meldung Keine VPC-Dienstperimeter im aktuellen Bereich gefunden angezeigt. Klicken Sie in diesem Fall auf Zum Organisationsbereich wechseln, um zur Organisationsebene zu gelangen.
    4. Klicken Sie auf der Seite VPC Service Controls in der Tabelle auf den Namen des Dienstperimeters, den Sie ändern möchten.
    5. Klicken Sie auf der Seite Details zum Dienstperimeter auf Bearbeiten.
    6. Filtern Sie im Bereich Eingeschränkte Dienste nach dem Dienst pubsub.googleapis.com und wählen Sie ihn aus.
    7. Klicken Sie auf  Ausgewählte entfernen.
    8. Klicken Sie auf Speichern. Klicken Sie im Bestätigungsdialogfeld auf Bestätigen, um die Pub/Sub API aus Ihrem VPC Service Controls-Dienstperimeter zu entfernen.
  2. Fügen Sie den Pub/Sub-Trigger in Ihrer Integration hinzu und konfigurieren Sie ihn.
  3. Veröffentlichen Sie die Integration.
  4. Fügen Sie die Pub/Sub API wieder dem Dienstperimeter hinzu:
    1. Zur Seite VPC Service Controls.

      Zu „VPC Service Controls“

    2. Klicken Sie auf der Seite VPC Service Controls in der Tabelle auf den Dienstperimeter, den Sie zuvor geändert haben.
    3. Klicken Sie auf der Seite Details zum Dienstperimeter auf Bearbeiten.
    4. Klicken Sie im Bereich Eingeschränkte Dienste auf  Dienste hinzufügen.
    5. Filtern Sie nach dem Dienst pubsub.googleapis.com und wählen Sie ihn aus.
    6. Klicken Sie auf Ausgewählte Dienste hinzufügen.
    7. Klicken Sie auf Speichern. Klicken Sie im Bestätigungsdialogfeld auf Bestätigen, um die Pub/Sub API wieder dem VPC Service Controls-Dienstperimeter hinzuzufügen.

Preise

Für den Cloud Pub/Sub-Trigger und den Salesforce-Trigger müssen Sie keinen Connector erstellen. Wenn Sie jedoch die Connectors-Aufgabe verwenden, um eine Verbindung zu Pub/Sub oder Salesforce herzustellen, wird Ihnen die Connector-Nutzung in Rechnung gestellt. Informationen zu den Preisen finden Sie unter Preise für Application Integration.

Hinweise

  • Die maximale Größe einer Pub/Sub-Nachricht beträgt 10 MB. Informationen zu allen Einschränkungen von Pub/Sub finden Sie unter Pub/Sub-Kontingente und -Limits.
  • Es ist möglich, dass Pub/Sub dieselbe Nachricht mehrmals in ein Thema schreibt. Informationen zum Verhalten von Pub/Sub finden Sie unter Mindestens einmalige Zustellung. Daher müssen Sie Ihre Integration so idempotent gestalten, dass eine Nachricht nicht mehr als einmal in ein Thema geschrieben werden kann.

    Hinweis: Das Feld message_id im Nachrichtenheader identifiziert eine Pub/Sub-Nachricht eindeutig.

  • Wenn Sie die Veröffentlichung einer Integration aufheben, wird das Pub/Sub-Abo nicht gelöscht, um den Verlust von Nachrichten zu vermeiden. Wenn Sie jedoch die veröffentlichte Version oder alle Integrationsversionen einer Integration löschen, wird auch das Pub/Sub-Abo gelöscht.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte