Nachdem Sie Ihre Funktion mit Cloud Run erstellt und bereitgestellt haben, können Sie festlegen, dass sie als Reaktion auf verschiedene Szenarien ausgeführt wird, indem Sie einen Trigger angeben.
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).
Wie Ihre Funktion aufgerufen oder ausgelöst wird, hängt vom Funktionstyp ab, den Sie beim Erstellen des Codes angeben.
- CloudEvent-Trigger: Reagieren auf Ereignisse in Ihrem Google Cloud -Projekt und entsprechen CloudEvents-Funktionen (auch ereignisgesteuerte 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 (keine Eventarc-Dienste) 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, können Sie Trigger beim Bereitstellen der Funktion in der Google Cloud Console oder nach der Bereitstellung der Funktion mit der gcloud CLI angeben.
Sie können dieselbe Funktion nicht gleichzeitig an mehrere Trigger binden. Sie können jedoch erreichen, dass ein einziges 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:
CloudEvent-Trigger:
- Von Eventarc ausgelöste Pub/Sub-Ereignisse
- Von Eventarc ausgelöste Cloud Storage-Ereignisse
- Von Eventarc ausgelöste Firestore-Ereignisse
- Allgemeine Eventarc-Trigger
- Unterstützung für jeden von Eventarc unterstützten Ereignistyp, einschließlich über 90 Ereignisquellen mit Cloud-Audit-Logs
HTTP-Trigger:
- Mit einer HTTP-Anfrage aufrufen
- Dienste als Teil eines Workflows mit Workflows aufrufen
- Dienste mit Cloud Scheduler nach Zeitplan aufrufen
- Asynchrone Aufgaben mit Cloud Tasks ausführen
- Dienste über ein Pub/Sub-Push-Abo auslösen
- Pub/Sub-Nachrichten können über HTTP-Anfragen direkt an eine Funktion weitergeleitet oder in Eventarc als CloudEvent-Trigger gekapselt werden.
Alle CloudEvents-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 auch eine CloudEvent-Funktion 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. Mit Aufgaben können Sie Funktionsaufrufe auch drosseln oder 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.