Bus zum Weiterleiten von Nachrichten erstellen

Mit einem Eventarc Advanced-Bus können Sie den Nachrichtenfluss durch Ihr System zentralisieren, überwachen und erfassen. Er dient als Router. Er empfängt Ereignisse von einer Nachrichtenquelle oder von einem Anbieter und bewertet sie gemäß einer Registrierung. Eine Anmeldung weist ein Abo einem bestimmten Bus zu und definiert die Abgleichkriterien für Nachrichten, die dann entsprechend weitergeleitet werden. Weitere Informationen finden Sie unter Registrierung zum Empfangen von Ereignissen erstellen.

Ein Bus kann von Ereignisanbietern und Zielen in Ihrem Projekt oder in anderen Projekten verwendet werden. Weitere Informationen finden Sie unter Projektlayouts.

Erforderliche Rollen

Eine IAM-Rolle (Identity and Access Management) enthält eine Reihe von Berechtigungen, mit denen Sie bestimmte Aktionen für Google Cloud-Ressourcen ausführen können. Die folgenden Rollen und Berechtigungen sind erforderlich, wenn Sie einen Bus zum Weiterleiten von Nachrichten erstellen:

  • Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Eventarc Admin (roles/eventarc.admin) oder Eventarc Message Bus Admin (roles/eventarc.messageBusAdmin) für Ihr Busprojekt zuzuweisen, um die Berechtigung zum Erstellen eines Busses zu erhalten. Diese vordefinierten Rollen enthalten die Berechtigung eventarc.messageBuses.create, die zum Erstellen eines Busses erforderlich ist.
  • Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Eventarc Message Bus User (roles/eventarc.messageBusUser) für Ihr Busprojekt zuzuweisen, um die Berechtigung zum Verwenden eines Busses zu erhalten. Diese vordefinierte Rolle enthält die Berechtigung eventarc.buses.use, die zum Verwenden eines Busses erforderlich ist.
  • Zum Erstellen einer Pipeline und einer Registrierung sind zusätzliche Berechtigungen erforderlich. Weitere Informationen finden Sie unter Erforderliche Rollen beim Erstellen einer Registrierung.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten. Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Bus erstellen

Sie können einen Bus in der Google Cloud Console oder mit der gcloud CLI erstellen.

Console

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

    Zu „Bus“

  2. Klicken Sie auf Bus erstellen.

  3. Führen Sie auf der Seite Bus erstellen die folgenden Schritte aus:

    1. Geben Sie einen Busnamen ein. Dies ist die ID Ihres Busses.
    2. Optional: Geben Sie einen Anzeigenamen des Busses ein, der auf der Seite Busdetails angezeigt wird.
    3. Wählen Sie in der Liste Region eine unterstützte Region aus, in der Sie den Bus bereitstellen möchten.
    4. Akzeptieren Sie unter Verschlüsselung die Standardeinstellung Von Google verwalteter Verschlüsselungsschlüssel oder wählen Sie Cloud KMS-Schlüssel aus. Weitere Informationen finden Sie unter Vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) verwenden.

    5. Wenn Sie Cloud KMS-Schlüssel auswählen, gehen Sie so vor:

      1. Wählen Sie in der Liste Schlüsseltyp eine Methode zum Verwalten Ihrer Schlüssel aus.

        Sie können Ihre Schlüssel manuell verwalten oder Autokey verwenden, mit dem Sie Schlüsselringe und Schlüssel bei Bedarf generieren können. Wenn die Option Cloud KMS mit Autokey deaktiviert ist, wurde sie noch nicht in den aktuellen Ressourcentyp eingebunden.

      2. Wählen Sie unter Cloud KMS-Schlüssel auswählen einen Schlüssel aus.

        Sie müssen eine Region auswählen, bevor Sie Ihre vom Kunden verwalteten Schlüssel aufrufen können.

      3. Optional: Sie können den Ressourcennamen des Schlüssels, den Sie verwenden möchten, manuell in die Liste Wählen Sie einen vom Kunden verwalteten Schlüssel aus eingeben. Klicken Sie dazu auf Schlüssel manuell eingeben und geben Sie den Schlüsselnamen im angegebenen Format ein.

      4. Wenn Sie dazu aufgefordert werden, weisen Sie dem Eventarc-Dienst-Agent die Rolle cloudkms.cryptoKeyEncrypterDecrypter zu.

    6. Optional: Wenn Sie eine Nachrichtenquelle hinzufügen möchten, klicken Sie auf Quelle hinzufügen.

      1. Übernehmen Sie im Bereich Nachrichtenquelle hinzufügen für den Google API-Nachrichtenanbieter den Standardwert google-api-source oder geben Sie einen anderen Quellnamen ein.

      2. Klicken Sie auf Erstellen.

        Dadurch wird die automatische Erfassung von Ereignissen ermöglicht, die direkt aus Google-Quellen stammen.

        Es werden nur Ereignisse aus Ressourcen im selben Google Cloud-Projekt wie der Bus veröffentlicht. Weitere Informationen finden Sie unter Ereignisse aus Google-Quellen veröffentlichen.

    7. Optional: Klicken Sie auf Label hinzufügen, um Labels hinzuzufügen. Labels sind Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud-Ressourcen organisieren können. Weitere Informationen finden Sie unter Was sind Labels?

  4. Klicken Sie auf Erstellen.

gcloud

  1. Öffnen Sie ein Terminalfenster.

  2. Erstellen Sie mit dem Befehl gcloud beta eventarc message-buses create einen Bus.

    gcloud beta eventarc message-buses create BUS_NAME \
    --location=REGION

    Ersetzen Sie Folgendes:

    • BUS_NAME: die ID oder voll qualifizierte Kennzeichnung des Busses

    • REGION: ein unterstützter Standort für den Bus

      Alternativ können Sie die Speicherorteigenschaft der Google Cloud CLI festlegen:

      gcloud config set eventarc/location REGION

    Optional: Sie können auch die folgenden Flags verwenden:

    • --async, um sofort vom Befehl zurückzukehren, ohne auf den Abschluss des laufenden Vorgangs zu warten.
    • --crypto-key, um den voll qualifizierten Namen eines vom Kunden verwalteten Verschlüsselungsschlüssels anzugeben. Andernfalls werden von Google verwaltete Schlüssel verwendet.
    • --logging-config, um die Protokollierungsebene zu konfigurieren. Sie muss einen der folgenden Werte haben: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY.

Bus löschen

Sie können einen Bus in der Google Cloud Console oder mit der gcloud CLI löschen.

Console

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

    Zu „Bus“

  2. Klicken Sie auf den Namen des Busses, den Sie löschen möchten.

    Die Seite Busdetails wird geöffnet.

  3. Klicken Sie auf Löschen.

  4. Wenn Sie aufgefordert werden, den Bus zu löschen, setzen Sie ein Häkchen in das Kästchen Möchten Sie fortfahren?, um zu bestätigen, dass alle Nachrichtenquellen, die für die Verwendung des Busses konfiguriert sind, ihn nicht mehr verwenden können.

  5. Geben Sie Delete ein, um den Löschvorgang zu bestätigen.

  6. Klicken Sie auf Löschen.

gcloud

  1. Öffnen Sie ein Terminalfenster.

  2. Verwenden Sie den Befehl gcloud beta eventarc message-buses delete, um einen Bus zu löschen.

    gcloud beta eventarc message-buses delete BUS_NAME \
    --location=REGION

    Ersetzen Sie Folgendes:

    • BUS_NAME: die ID oder voll qualifizierte Kennzeichnung des Busses
    • REGION: den unterstützten Standort für den Bus

Nächste Schritte