In dieser Anleitung erfahren Sie, wie Sie eine HTTP-Cloud Run-Funktion mit Cloud Scheduler und mit Ausrichtung auf einen HTTP-Endpunkt auslösen. Verwenden Sie eine HTTP-Funktion, wenn Ihre Funktion einen URL-Endpunkt haben und auf HTTP-Anfragen antworten muss, z. B. für Webhooks.
Sie können auch eine ereignisgesteuerte Funktion planen, wenn Ihre Funktion direkt als Reaktion auf Ereignisse in Ihrem Google Cloud-Projekt ausgelöst werden soll, z. B. Nachrichten in einem Pub/Sub-Thema oder Änderungen in einem Cloud Storage-Bucket. Weitere Informationen finden Sie unter Arten von Cloud Run-Funktionen.
Cloud Scheduler wird häufig dazu verwendet, die Ausführung einer Cloud Run-Funktion zu planen. In dieser Anleitung wird Folgendes beschrieben:
- Erstellen Sie eine einfache HTTP-Cloud Run-Funktion.
- Cloud Scheduler-Job erstellen
- Führen Sie den Cloud Scheduler-Job aus.
- Prüfen Sie, ob die Cloud Run-Funktion vom Cloud Scheduler-Job ausgelöst wurde.
Kosten
In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
Hinweise
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Cloud Run > Cloud Run Invoker role to the service account.
To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.
- Click Continue.
-
Click Done to finish creating the service account.
-
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Cloud Run > Cloud Run Invoker role to the service account.
To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.
- Click Continue.
-
Click Done to finish creating the service account.
-
- Cloud Run-Funktionen verwenden standardmäßig das automatisch erstellte Compute Engine-Standarddienstkonto als Laufzeitdienstkonto. Sie können dieses Dienstkonto für diese Anleitung verwenden. Abhängig von der Konfiguration Ihrer Organisationsrichtlinie wird dem Standarddienstkonto für Ihr Projekt jedoch möglicherweise nicht automatisch die Rolle „Bearbeiter“ zugewiesen. In diesem Fall müssen Sie dem Dienstkonto die folgenden Rollen zuweisen:
- Artifact Registry-Writer (
roles/artifactregistry.writer
) - Log-Autor (
roles/logging.logWriter
) - Storage-Objekt-Betrachter (
roles/storage.objectViewer
)
- Artifact Registry-Writer (
Sie müssen die Rolle „Cloud Run Invoker“ gewähren, da bei Cloud Run Functions (2. Generation) Aufrufberechtigungen über die Verwaltung des zugrunde liegenden Cloud Run-Dienstes verfügbar sind.
HTTP-Cloud Run-Funktion erstellen
Erstellen Sie eine HTTP-Funktion, die von Cloud Scheduler ausgelöst wird.
Rufen Sie in der Google Cloud Console die Seite Cloud Run-Funktionen auf.
Klicken Sie auf
Funktion erstellen.Führen Sie im Abschnitt Grundlagen folgende Schritte aus:
- Wählen Sie in der Liste Umgebung die Option Cloud Run-Funktion aus.
- Geben Sie einen Namen für die Funktion ein.
- Wählen Sie in der Liste Region eine Region aus.
Führen Sie im Abschnitt Trigger folgende Schritte aus:
- Wählen Sie in der Liste Triggertyp die Option HTTPS aus.
Wählen Sie für die Authentifizierung Authentifizierung erforderlich aus.
Weitere Informationen finden Sie unter Zum Aufrufen authentifizieren (2. Generation).
Übernehmen Sie die anderen Standardeinstellungen und klicken Sie auf Weiter.
Ändern Sie die Standardlaufzeitsprache und den Beispielcode nicht. Der Code verwendet keine Cloud-Dienste und es müssen keine zusätzlichen Berechtigungen aktiviert werden. Klicken Sie auf Bereitstellen.
Klicken Sie nach der Bereitstellung der Funktion auf den Tab Trigger.
Kopieren Sie die HTTP-URL für die Funktion.
Cloud Scheduler-Job erstellen
Erstellen Sie einen Cloud Scheduler-Job, der eine Aktion über HTTP auslöst.
Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.
Klicken Sie auf
Job erstellen.Geben Sie einen Namen für den Job ein.
Wählen Sie in der Liste Region eine Region aus.
Geben Sie die Häufigkeit der Ausführung des Jobs im Unix-Cron-Format an:
30 16 * * 7
Weitere Informationen finden Sie unter Format und Zeitzone für Cronjobs.
Wählen Sie in der Liste Zeitzone eine Zeitzone aus.
Klicken Sie auf Weiter.
Wählen Sie in der Liste Zieltyp die Option HTTP aus.
Geben Sie im Feld URL die HTTP-URL der Funktion ein, die Sie zuvor kopiert haben.
Wählen Sie in der Liste Auth-Header die Option OIDC-Token hinzufügen aus.
Wählen Sie in der Liste Dienstkonto das zuvor erstellte Dienstkonto aus.
Geben Sie im Feld Zielgruppe die HTTP-URL der Funktion ein, die Sie zuvor kopiert haben.
Klicken Sie auf Erstellen.
Sie haben einen Cronjob erstellt, der Ihre Cloud Run-Funktion sonntags um 16:30 Uhr ausführt.
Cloud Scheduler-Job ausführen
Sie können den erstellten Job jetzt ausführen.
Rufen Sie in der Google Cloud Console die Seite „Cloud Scheduler“ auf.
Klicken Sie das Kästchen für den von Ihnen erstellten Job an und dann auf Erzwungene Ausführung.
Beim ersten Aufruf kann es einige Minuten dauern, bis der erste Job, der in einem Projekt erstellt wurde, konfiguriert und ausgeführt wird.
Nach der Ausführung des Jobs sollte für den Status der letzten Ausführung
Success
angezeigt werden.
Ergebnisse in Cloud Run-Funktionen prüfen
Sie können prüfen, ob Ihre Cloud Run-Funktion erfolgreich von Ihrem Cronjob ausgelöst und ausgeführt wird.
Wechseln Sie in der Google Cloud Console zur Seite Cloud Run-Funktionen.
Klicken Sie auf den Funktionsnamen.
Die Seite Funktionsdetails wird geöffnet. Im Diagramm Aufrufe/Sekunde sehen Sie die erste Aufrufung der Funktion.
Klicken Sie auf den Tab Logs.
Sie sollten einen Logeintrag wie den folgenden sehen:
POST 200 146 B 5 ms Google-Cloud-Scheduler https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME
Bereinigen
Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.
Projekt löschen
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Anleitungsressourcen löschen
Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.
Klicken Sie auf das Kästchen neben Ihrem Job.
Klicken Sie auf
Löschen und bestätigen Sie den Löschvorgang.Wechseln Sie in der Google Cloud Console zur Seite Cloud Run-Funktionen.
Klicken Sie das Kästchen neben Ihrer Funktion an.
Klicken Sie auf
Löschen und bestätigen Sie den Löschvorgang.Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.
Klicken Sie das Kästchen neben dem von Ihnen erstellten Dienstkonto an.
Klicken Sie auf
Löschen und bestätigen Sie den Löschvorgang.