Trigger mit Ereignissen

Sie können einen Eventarc-Trigger erstellen, damit Ihr Cloud Run-Dienst Benachrichtigungen über ein bestimmtes Ereignis oder einen Satz von Ereignissen erhält. Durch Angabe von Filtern für den Trigger können Sie das Routing des Ereignisses konfigurieren, einschließlich der Ereignisquelle und des Cloud Run-Zieldienstes.

Ereignisse, die an Ihren Cloud Run-Dienst gesendet werden, werden in Form von HTTP-Anfragen empfangen.

Die folgenden Ereignistypen lösen Anfragen an Ihren Dienst aus:

Auf dieser Seite wird gezeigt, wie Sie auf der Seite der Cloud Run-Konsole einen Trigger erstellen.

Sie können einen Eventarc-Trigger auch über die Google Cloud CLI oder über die Seite der Eventarc-Konsole erstellen. Folgen Sie der Anleitung zum Erstellen eines Triggers für bestimmte Anbieter, Ereignistypen und Ziele.

Erstellung eines Triggers vorbereiten

Bevor Sie einen Trigger erstellen, müssen Sie folgende Voraussetzungen erfüllen:

  1. Jeder Eventarc-Trigger ist zur Zeit der Erstellung des Triggers mit einem IAM-Dienstkonto (Identity and Access Management) verknüpft. Sie können ein vom Nutzer verwaltetes Dienstkonto angeben, das der Trigger als Standardidentität verwendet. Achten Sie darauf, dass Sie dem Dienstkonto des Triggers die erforderlichen Rollen und Berechtigungen erteilen.

    Um beispielsweise Ereignisse an Cloud Run-Dienste zu senden, die eine Authentifizierung erfordern, muss das Dienstkonto für den Eventarc-Trigger die IAM-Rolle „Cloud Run Invoker“ haben.

  2. Wenn Sie einen Trigger für ein direktes Ereignis aus Cloud Storage erstellen, weisen Sie dem Cloud Storage-Dienstkonto die Rolle pubsub.publisher zu:

    SERVICE_ACCOUNT="$(gsutil kms serviceaccount -p PROJECT_ID)"
    
    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:${SERVICE_ACCOUNT}" \
        --role='roles/pubsub.publisher'
    

    Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID. Sie finden Ihre Projekt-ID auf der Willkommensseite der Google Cloud Console.

Trigger über die Konsole erstellen

Sie können die Cloud Run-Konsolenseite verwenden, um einen Eventarc-Trigger zu erstellen.

  1. Aktivieren Sie bei Bedarf die Eventarc API.

    API aktivieren

  2. Rufen Sie in der Google Cloud Console Cloud Run auf.

    Öffnen Sie Cloud Run.

  3. Klicken Sie in der Liste der Dienste auf einen vorhandenen Dienst oder erstellen Sie einen neuen Dienst.

  4. Klicken Sie auf der Seite „Dienstdetails“ auf den Tab Trigger.

  5. Klicken Sie auf Eventarc-Trigger hinzufügen.

    Der Bereich Eventarc-Trigger wird geöffnet. Informationen zum Routing von Ereignissen finden Sie unter Optionen für das Ereignisrouting.

  6. Folgen Sie der Anleitung zum Erstellen eines Triggers für bestimmte Anbieter, Ereignistypen und -Ziele und lesen Sie die Anleitung in der Konsole im Abschnitt „Trigger erstellen“.

  7. Wählen Sie das Dienstkonto aus, das Ihren Cloud Run-Dienst aufruft.

    Oder erstellen Sie ein neues Dienstkonto.

    Dies gibt die E-Mail-Adresse des IAM-Dienstkontos an, die mit dem Trigger verknüpft ist. Bei Cloud Run-Zielen wird dieses Dienstkonto verwendet, um beim Aufrufen des Dienstes Identitätstokens zu generieren.

  8. Geben Sie optional den Dienst-URL-Pfad an, an den die eingehende Anfrage gesendet werden soll.

    Dies ist der relative Pfad im Zieldienst, an den die Ereignisse für den Trigger gesendet werden sollen. Beispiel: /, /route, route, route/subroute

  9. Nachdem Sie den Trigger erstellt haben, können Sie seinen Status prüfen. Dazu muss im Tab Trigger ein Häkchen angezeigt werden.

Nächste Schritte