Unterstützte Connectors für Application Integration

Solace-Trigger

Der Solace-Trigger ist ein Connector-Ereignistrigger, mit dem Sie eine Integration basierend auf den Solace-Ereignissen aufrufen können, die Sie in Ihrer Solace-Verbindung abonniert haben.

Hinweise

Wenn Sie eine neue Verbindung für den Solace-Trigger erstellen oder konfigurieren möchten, benötigen Sie die folgende IAM-Rolle für das Projekt:

  • Connector-Administrator (roles/connectors.admin)

    • Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Weisen Sie dem Dienstkonto, das Sie für den Solace-Trigger verwenden möchten, die folgenden IAM-Rollen zu:

  • Application Integration Invoker (roles/integrations.integrationInvoker)

    • Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

Solace-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um Ihrer Integration einen Solace-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. Klicken Sie auf das Element Solace-Trigger und platzieren Sie es im Integrationseditor.

    6. Wenn Sie den Solace-Trigger konfigurieren möchten, können Sie entweder eine vorhandene Solace-Verbindung in Integration Connectors verwenden oder eine neue Solace-Verbindung mit der Inline-Option zum Erstellen von Verbindungen erstellen.

Solace-Trigger mit einer vorhandenen Verbindung konfigurieren

Sie können den Solace-Trigger mit einer vorhandenen Solace-Verbindung in Integration Connectors konfigurieren. Der Solace-Trigger ist ein Connector-Ereignistrigger. Daher können Sie nur eine Solace-Verbindung mit aktivierter Ereignisregistrierung verwenden, um den Trigger zu konfigurieren.

Informationen zum Konfigurieren eines Solace-Triggers mit einer neuen Solace-Verbindung finden Sie unter Solace-Trigger mit einer neuen Verbindung konfigurieren.

So konfigurieren Sie einen Solace-Trigger mit einer vorhandenen Solace-Verbindung:

  1. Klicken Sie im Integrationseditor auf das Element Solace-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
  2. Klicken Sie auf Trigger konfigurieren.
  3. Geben Sie auf der Seite Connector Event Trigger Editor die folgenden Konfigurationsdetails an:
    1. Region:Wählen Sie die Region Ihrer Solace-Verbindung aus.
    2. Verbindung:Wählen Sie die Solace-Verbindung aus, die Sie verwenden möchten.

      In der Anwendungsintegration werden nur die Solace-Verbindungen angezeigt, die aktiv sind und für die ein Ereignisabo aktiviert ist.

    3. Wählen Sie Queue oder Thema als JMS Source Type aus.
      • Wenn Sie Queue auswählen, geben Sie den Namen der Solace-Warteschlange in der Spalte JMS Source Name an.
      • Wenn Sie Topic auswählen, geben Sie den Namen des Solace-Themas in der Spalte „JMS-Quellname“ an.
    4. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für den Solace-Trigger aus.
  4. Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

Solace-Trigger mit einer neuen Verbindung konfigurieren

Führen Sie die folgenden Schritte aus, um den Solace-Trigger mit einer neuen Solace-Verbindung zu konfigurieren:

  1. Klicken Sie im Integrationseditor auf das Element Solace-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
  2. Klicken Sie auf Trigger konfigurieren.
  3. Überspringen Sie das Feld Region.
  4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
  5. Führen Sie die folgenden Schritte im Bereich Verbindung erstellen aus:
    1. Wählen Sie im Schritt Standort den Standort für die neue Solace-Verbindung aus:
      1. Region: Wählen Sie einen Standort aus der Drop-down-Liste aus.

        Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

      2. Klicken Sie auf Weiter.
    2. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
      1. Connector: Wählen Sie Solace aus der Drop-down-Liste der verfügbaren Connectors aus.
      2. Connector-Version: Wählen Sie die Connector-Version aus der Drop-down-Liste der verfügbaren Versionen aus.
      3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein.

        Verbindungsnamen müssen die folgenden Kriterien erfüllen:

        • Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
        • Buchstaben müssen Kleinbuchstaben sein.
        • Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
        • Verbindungsnamen dürfen maximal 49 Zeichen haben.
        • Bei Connectors, die Ereignisabos unterstützen, dürfen die Verbindungsnamen nicht mit dem Präfix „goog“ beginnen.
      4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
      5. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
      6. Wenn Sie die Verbindung für Ereignisabos verwenden möchten, wählen Sie Ereignisabo aktivieren aus. Wenn Sie diese Option auswählen, wird das Ereignisabo mit Aktionen aktiviert.
      7. Message VPN: Das Solace Pub/Sub+-Message-VPN, mit dem Sie eine Verbindung herstellen möchten. Eine Verbindung ist für ein Message-VPN spezifisch. Wenn Sie viele Message-VPNs haben, müssen Sie für jedes Message-VPN eine separate Verbindung erstellen.
      8. Name der Standardwarteschlange: Der Name der Standardwarteschlange kann beim Ausführen der Aktion überschrieben werden.
      9. Name des Standardthemas: Der Name des Themas, mit dem eine Verbindung hergestellt werden soll.
      10. Optional können Sie SSL verwenden. Wählen Sie dazu SSL aktivieren aus und geben Sie die Details zur SSL-Konfiguration an.
        1. Wählen Sie einen Truststore-Typ aus. Sie können Öffentlich, Privat oder Unsichere Verbindung angeben.
        2. Wählen Sie die Zertifikate entsprechend Ihrer Auswahl für den Trust Store aus. Wenn Sie beispielsweise Privat auswählen, geben Sie einen benutzerdefinierten Truststore an.
        3. Wenn Sie mTLS verwenden, wählen Sie die Schlüsselspeicherzertifikate im Abschnitt Schlüsselspeicher aus.
        4. Wählen Sie optional die TLS-Version aus.
        5. Geben Sie die unterstützte Cipher-Suite ein. Geben Sie mehrere Cipher-Suites als durch Kommas getrennte Werte ein. Weitere Informationen finden Sie unter Unterstützte Chiffrierverfahren.
      11. Optional: Konfigurieren Sie die Verbindungsknoteneinstellungen.
        • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
        • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

        Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.
      12. Klicken Sie optional auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
      13. Klicken Sie auf Weiter.
    3. Geben Sie im Abschnitt Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten.
      1. Zieltyp: Wählen Sie einen Zieltyp aus.
        • Wenn Sie den Zielhostnamen oder die Ziel-IP-Adresse angeben möchten, wählen Sie Hostadresse aus und geben Sie die Adresse in das Feld Host 1 ein.
        • Wenn Sie eine private Verbindung herstellen möchten, wählen Sie Endpunktanhang aus und wählen Sie den erforderlichen Anhang aus der Liste Endpunktanhang aus.

        Wenn Sie eine öffentliche Verbindung zu Ihren Back-End-Systemen mit zusätzlicher Sicherheit herstellen möchten, können Sie statische ausgehende IP-Adressen für Ihre Verbindungen konfigurieren und dann Ihre Firewallregeln konfigurieren, um nur bestimmte statische IP-Adressen zuzulassen.

      2. Klicken Sie auf Weiter.
    4. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
      1. Wählen Sie einen Authentifizierungstyp aus und geben Sie die relevanten Details ein.

        Die folgenden Authentifizierungstypen werden von der Solace-Verbindung unterstützt:

        • Anonym
        • Nutzername und Passwort

        2. Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

      2. Klicken Sie auf Weiter.
    5. Konfigurieren Sie im Bereich Details zum Ereignisabo die ereignisbezogenen Details.
      • Geben Sie die Konfiguration für unzustellbare Nachrichten ein. Wenn Sie ein Thema für fehlgeschlagene Nachrichten konfigurieren, schreibt die Verbindung die nicht verarbeiteten Ereignisse in das angegebene Pub/Sub-Thema. Geben Sie die folgenden Informationen ein:
        1. Projekt-ID für Unzustellbarkeitsnachrichten : Die Google Cloud-Projekt-ID, in der Sie das Pub/Sub-Thema für Unzustellbarkeitsnachrichten konfiguriert haben.
        2. Thema für unzustellbare Nachrichten : Das Pub/Sub-Thema, in das Sie die Details des nicht verarbeiteten Ereignisses schreiben möchten.
    6. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
    7. Klicken Sie auf Erstellen.

    Trigger-Ausgabe

    Es dauert einige Minuten, bis der Solace-Trigger die Konfiguration des Ereignisabos abgeschlossen hat. Den Status Ihres Ereignisabos können Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo einsehen.

    Der Solace-Trigger gibt den Status eines Ereignisabos mit den folgenden Status an:

    • Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
    • Active: Gibt an, dass der Trigger erfolgreich für ein Ereignisabo registriert wurde.
    • Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

    Neben dem Status des Ereignisabos werden im Bereich Details zum Ereignisabo auch andere Details wie Verbindungsregion, Verbindungsname und Name des Ereignisabos angezeigt.

    Variable „Trigger-Ausgabe“

    Für jedes Ereignis generiert der Solace-Trigger eine ConnectorEventPayload-Ausgabevariable (im JSON-Format), die Sie in nachgelagerten Aufgaben verwenden können. Die Ausgabevariable enthält die Nutzlast aus Ihrem Solace-Ereignis. Beispiel: 

    {
"message": "Hello world",
"messageContentType": "Text"
}

    Ereignisabos ansehen

    So rufen Sie alle Ereignisabos auf, die mit einer Verbindung in Integration Connectors verknüpft sind, und verwalten sie:

    1. Rufen Sie die Seite Integration Connectors > Connections (Integration Connectors > Verbindungen) auf.

      Zur Seite „Verbindungen“

    2. Klicken Sie auf die Verbindung, für die Sie die Abos aufrufen möchten.
    3. Klicken Sie auf den Tab Event-Abos.

      Hier werden alle Ereignisabos für die Verbindung angezeigt.

    Solace-Trigger bearbeiten

    Sie können einen Solace-Trigger bearbeiten, um die Verbindungs- und Ereignisabonnementdetails zu ändern oder zu aktualisieren.

    So bearbeiten Sie einen Solace-Trigger:

    1. Klicken Sie im Integrationseditor auf das Element Solace-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
    2. Klicken Sie auf Solace-Trigger konfigurieren.
    3. Führen Sie auf der Seite Connector Event Trigger Editor (Editor für Connector-Ereignistrigger) die folgenden Schritte aus:
      1. Wenn Sie das zuvor konfigurierte Ereignis-Abo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie auf Löschen.
      2. Aktualisieren Sie die Verbindungs- und Ereignisaboeinstellungen nach Bedarf.
      3. Klicken Sie auf Fertig.

      4. Die aktualisierten Details zur Verbindung und zum Ereignisabo finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo.

    Kontingente und Limits

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

    Nächste Schritte