Ereignisgesteuerte Cloud Run-Funktion planen

In dieser Anleitung erfahren Sie, wie Sie mit Cloud Scheduler eine ereignisgesteuerte Cloud Run-Funktion auslösen, indem Sie ein Pub/Sub-Thema als Ziel festlegen. Verwenden Sie eine ereignisgesteuerte Funktion, 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.

Sie können auch eine HTTP-Funktion planen , indem Sie den HTTP-Endpunkt Ihrer Funktion als Ziel festlegen. Verwenden Sie eine HTTP-Funktion, wenn Ihre Funktion einen URL-Endpunkt haben und auf HTTP-Anfragen antworten muss, z. B. für Webhooks. 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:

1. Erstellen Sie eine einfache Cloud Run-Funktion, die ein Pub/Sub-Thema abonniert.
2. Erstellen Sie einen Cloud Scheduler-Job, der eine Nachricht im Pub/Sub-Thema veröffentlicht.
3. Führen Sie den Cloud Scheduler-Job aus.
4. 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:

• Cloud Run functions
• Cloud Scheduler
• Pub/Sub

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen. Verwenden Sie den Preisrechner.

Neuen Nutzern von Google Cloud steht möglicherweise eine kostenlose Testversion zur Verfügung.

Hinweis

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Google Cloud-Konto haben, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler, Eventarc APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

2. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
3. Select your project.

4. 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.

5. Click Create and continue.

6. 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.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
7. Click Continue.

8. 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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler, Eventarc APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

2. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
3. Select your project.

4. 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.

5. Click Create and continue.

6. 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.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
7. Click Continue.

8. Click Done to finish creating the service account.

Sie müssen die Rolle „Cloud Run-Aufrufer“ zuweisen, da in Cloud Run-Funktionen (2. Generation), Aufrufberechtigungen über die Verwaltung des zugrunde liegenden Cloud Run-Dienstes verfügbar sind.

1. Standardmäßig verwendet Cloud Run-Funktionen das automatisch erstellte Compute Engine-Standarddienstkonto als Laufzeitdienstkonto. Sie können dieses Dienstkonto verwenden, um diese Anleitung auszuprobieren. Abhängig von der Konfiguration Ihrer Organisationsrichtlinie kann dem Standarddienstkonto für Ihr Projekt jedoch nicht automatisch die Rolle „Bearbeiter“ zugewiesen werden.
   In diesem Fall müssen Sie dem Dienstkonto die folgenden Rollen zuweisen:
   1. Artifact Registry-Writer (roles/artifactregistry.writer)
   2. Logs Writer (roles/logging.logWriter)
   3. Storage-Objekt-Betrachter (roles/storage.objectViewer)

Ereignisgesteuerte Cloud Run-Funktion erstellen

Erstellen Sie eine ereignisgesteuerte Funktion, die direkt als Reaktion auf Ereignisse in Ihrem Google Cloud Projekt ausgelöst wird. In diesem Fall ist das eine Nachricht, die in einem Pub/Sub-Thema veröffentlicht wird.

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run-Funktionen.

   Zu den Cloud Run-Funktionen

2. Klicken Sie auf Funktion erstellen.

3. Führen Sie im Abschnitt Grundlagen folgende Schritte aus:

   1. Wählen Sie in der Liste Umgebung die Option 2. Generation aus.
   2. Geben Sie einen Namen für Ihre Funktion ein.
   3. Wählen Sie in der Liste Region eine Region aus.

4. Führen Sie im Abschnitt Trigger folgende Schritte aus:

   1. Wählen Sie in der Liste Triggertyp die Option Cloud Pub/Sub aus.
   2. Wählen Sie in der Liste Cloud Pub/Sub-Thema ein vorhandenes Thema aus oder klicken Sie auf Thema erstellen , um ein neues Thema zu erstellen. Notieren Sie sich den Namen des Themas, da Sie ihn in einem späteren Schritt benötigen.

   3. Klicken Sie auf Weitere Optionen.

      Das Feld Eventarc-Trigger wird geöffnet.

5. Führen Sie im Feld Eventarc-Trigger folgende Schritte aus:

   1. Wenn Sie aufgefordert werden, dem Pub/Sub-Dienst zu erlauben, die Identitätstokens zu erstellen, die zum Aufrufen der Funktion erforderlich sind, klicken Sie auf Gewähren.
   2. Wählen Sie in der Liste Dienstkonto das zuvor erstellte Dienstkonto aus.
   3. Übernehmen Sie die anderen Standardeinstellungen.

   4. Klicken Sie auf Trigger speichern.

      Das Feld Eventarc-Trigger wird geschlossen.

6. Übernehmen Sie die anderen Standardeinstellungen und klicken Sie auf Weiter.

7. Ändern Sie die Standardlaufzeitsprache und den Beispielcode nicht. Der Code verwendet keine Cloud-Dienste und erfordert keine zusätzlichen aktivierten Berechtigungen. Klicken Sie auf Bereitstellen.

Cloud Scheduler-Job erstellen

Erstellen Sie einen Cloud Scheduler-Job mit einem Pub/Sub-Ziel.

1. Rufen Sie in der Google Cloud Console die Cloud Scheduler Seite auf.

   Zu Cloud Scheduler

2. Klicken Sie auf Job erstellen.

3. Geben Sie einen Namen für den Job ein.

4. Wählen Sie in der Liste Region eine Region aus.

5. Geben Sie die Häufigkeit der Ausführung des Jobs im Format unix-cron an:

   30 16 * * 7
   

   Weitere Informationen finden Sie unter Cronjob-Format und Zeitzone.

6. Wählen Sie in der Liste Zeitzone eine Zeitzone aus.

7. Klicken Sie auf Weiter.

8. Wählen Sie in der Liste Zieltyp die Option Pub/Sub aus.

9. Wählen Sie das zuvor erstellte Pub/Sub-Thema aus.

10. Geben Sie in das Feld Nachrichtentext einen String ein, der an das Pub/Sub-Zielthema gesendet werden soll. Beispiel: „Hallo Welt!“

11. Klicken Sie auf Erstellen.

Sie haben einen Cronjob erstellt, der sonntags um 16:30 Uhr eine Nachricht an Ihr Pub/Sub-Thema sendet. Ihre Cloud Run-Funktion hat dieses Thema abonniert.

Cloud Scheduler-Job ausführen

Sie können den erstellten Job jetzt ausführen.

1. Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.

   Zu Cloud Scheduler

2. Klicken Sie das Kästchen für den erstellten Job an und klicken Sie auf Ausführung erzwingen.

   Beim ersten Aufruf kann es einige Minuten dauern, bis der erste in einem Projekt erstellte Job konfiguriert und ausgeführt wird.

3. Nachdem der Job ausgeführt wurde, sollte unter 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 wurde.

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run-Funktionen.

   Zu den Cloud Run-Funktionen

2. Klicken Sie auf den Funktionsnamen.

   Die Seite Funktionsdetails wird geöffnet und im Diagramm Aufrufe/Sekunde wird der erste Aufruf der Funktion angezeigt.

3. Klicken Sie auf den Tab Logs.

   Es sollte ein Logeintrag ähnlich Hello, YOUR_STRING! angezeigt werden.

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

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.

   Zur Seite „Ressourcen verwalten“

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.

Anleitungsressourcen löschen

1. Rufen Sie in der Google Cloud Console die Cloud Scheduler Seite auf.

   Zu Cloud Scheduler

2. Klicken Sie auf das Kästchen neben Ihrem Job.

3. Klicken Sie auf „Löschen“ und bestätigen Sie den Löschvorgang.

4. Wechseln Sie in der Google Cloud Console zur Pub/Sub Seite.

   Zu Pub/Sub

5. Klicken Sie auf das Kästchen neben Ihrem Thema.

6. Klicken Sie auf „Löschen“ und bestätigen Sie den Löschvorgang.

7. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run-Funktionen.

   Zu den Cloud Run-Funktionen

8. Klicken Sie auf das Kästchen neben Ihrer Funktion.

9. Klicken Sie auf „Löschen“ und bestätigen Sie den Löschvorgang.

10. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.

    Zur Seite „Dienstkonten“

11. Klicken Sie auf das Kästchen neben dem erstellten Dienstkonto.

12. Klicken Sie auf „Löschen“ und bestätigen Sie den Löschvorgang.

Nächste Schritte

• Cloud Run mit Cloud Scheduler nach Zeitplan auslösen