Cloud Run-Funktionstrigger

Nachdem Sie Ihre Cloud Run-Funktion erstellt und bereitgestellt haben, können Sie festlegen, dass sie als Reaktion auf verschiedene Szenarien ausgeführt wird. Geben Sie dazu einen Trigger an. Auf dieser Seite finden Sie einen Überblick über die von Cloud Run-Funktionen unterstützten Trigger.

Triggerarten

Standardmäßig sind alle in Cloud Run bereitgestellten Funktionen aus Cloud Run-Quellen bereitgestellte Dienste mit einem HTTP-Endpunkt (run.app-URL). Wenn Sie zuvor eine Funktion mit dem Befehl gcloud functions oder der Cloud Functions V2 API erstellt haben, hat die Funktion standardmäßig einen cloudfunctions.net-HTTP-Endpunkt.

Wie Ihre Funktion aufgerufen oder ausgelöst wird, hängt vom Funktionstyp ab, den Sie beim Erstellen des Codes angeben.

  • Ereignisgesteuerte Trigger: Reagieren auf Ereignisse in Ihrem Google Cloud Projekt und entsprechen ereignisgesteuerten Funktionen (auch CloudEvent-Funktionen genannt). Sie müssen Eventarc verwenden, die Google-Implementierung der CloudEvents-Spezifikation, die die Erstellung ereignisgesteuerter Architekturen unterstützt, um Funktionen als Reaktion auf bestimmte Ereignisse auszulösen.
  • HTTP-Trigger: Reagieren auf HTTP(S)-Anfragen und entsprechen HTTP-Funktionen. Sie können andereGoogle Cloud -Dienste (nicht Eventarc) als Ereignisanbieter verwenden, um die Funktion über HTTP(S)-Anfragen aufzurufen.

Wenn Sie eine Funktion auslösen möchten, die auf Ereignisse in Ihrem Google Cloud Projekt reagiert, müssen Sie beim Bereitstellen der Funktion in der Google Cloud Console oder nach der Bereitstellung der Funktion mit der gcloud CLI Trigger angeben.

Sie können dieselbe Funktion nicht gleichzeitig an mehrere Trigger binden. Sie können jedoch erreichen, dass ein Ereignis die Ausführung mehrerer Funktionen bewirkt. Dazu stellen Sie mehrere Funktionen mit denselben Triggereinstellungen bereit.

Beispiele für Trigger

Die folgenden Trigger werden von Cloud Run-Funktionen unterstützt:

Alle ereignisgesteuerten Funktionen verwenden Eventarc für die Ereignisübermittlung. Pub/Sub-Trigger und Cloud Storage-Trigger werden als bestimmte Arten von Eventarc-Triggern implementiert.

Zusätzliche Trigger mit Pub/Sub und Webhooks

Da Cloud Run-Funktionen von Nachrichten in einem Pub/Sub-Thema ausgelöst werden können, lassen sich Cloud Run-Funktionen in jeden anderen Google-Dienst einbinden, der Pub/Sub als Ereignisbus unterstützt. Darüber hinaus können Sie sie durch HTTP-Trigger auch in jedem Dienst nutzen, der HTTP-Callbacks (Webhooks) bereitstellt. In den folgenden Abschnitten werden einige Beispielintegrationen beschrieben.

Cloud Logging

Mit Cloud Logging können Protokolle an ein Pub/Sub-Thema weitergeleitet werden, wo sie dann von Cloud Run-Funktionen verwendet werden können. Weitere Informationen finden Sie in der Cloud Logging-Dokumentation unter Senken konfigurieren und verwalten.

Cloud Scheduler

Sie können eine HTTP-Funktion planen, indem Sie einen Cloud Scheduler-Job erstellen, der eine Aktion über HTTP auslöst.

Sie können eine ereignisgesteuerte Funktion auch planen, wenn Ihre Funktion direkt als Reaktion auf Ereignisse in Ihrem Google Cloud -Projekt ausgelöst werden soll – beispielsweise wenn eine Nachricht in einem Pub/Sub-Thema veröffentlicht wird.

Cloud Tasks

Mit Cloud Tasks-HTTP-Zielaufgaben können Sie Aufgaben-Handler an einem beliebigen HTTP-Endpunkt ausführen. So kann eine HTTP-Funktion mit einem HTTP-Trigger als Aufgaben-Handler verwendet werden. Sie können Aufgaben auch verwenden, um Funktionsaufrufe zu drosseln oder zu begrenzen. Weitere Informationen finden Sie in der Cloud Tasks-Dokumentation unter HTTP-Zielaufgaben erstellen.

Gmail

Mit der Gmail Push Notification API können Sie Gmail-Ereignisse an ein Pub/Sub-Thema senden und mit Cloud Run nutzen.