Cloud Functions-HTTP-Funktion planen

---

In dieser Anleitung erfahren Sie, wie Sie mit Cloud Scheduler und einem HTTP-Endpunkt eine Cloud Functions-HTTP-Funktion auslösen können. Verwenden Sie eine HTTP-Funktion, wenn Ihre Funktion einen URL-Endpunkt haben und auf HTTP-Anfragen antworten soll, 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 Functions-Funktionen.

Die Planung der Ausführung einer Cloud Functions-Funktion ist ein häufiger Anwendungsfall für Cloud Scheduler. In dieser Anleitung wird Folgendes beschrieben:

1. Eine einfache HTTP-Cloud Functions-Funktion erstellen
2. einen Cloud Scheduler-Job erstellen
3. Führen Sie den Cloud Scheduler-Job aus.
4. Prüfen Sie, ob die Cloud Functions-Funktion vom Cloud Scheduler-Job ausgelöst wurde.

Kosten

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

• Cloud Functions
• Cloud Scheduler

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen. Neuen Google Cloud-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

Hinweise

1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, 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.

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

   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

3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

4. Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs aktivieren.

   Aktivieren Sie die APIs

5. Create a service account:

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

      Go to Create service account
   2. Select your project.

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

   4. Click Create and continue.

   5. 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. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

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

   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

7. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

8. Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs aktivieren.

   Aktivieren Sie die APIs

9. Create a service account:

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

      Go to Create service account
   2. Select your project.

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

   4. Click Create and continue.

   5. 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. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
   6. Click Continue.

   7. Click Done to finish creating the service account.

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

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

Cloud Functions-HTTP-Funktion erstellen

Erstellen Sie eine HTTP-Funktion, die von Cloud Scheduler ausgelöst wird.

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

   Zu Cloud Functions

2. Klicken Sie auf Funktion erstellen.

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

   1. Wählen Sie in der Liste Environment (Umgebung) die Option 2nd gen aus.
   2. Geben Sie einen Namen für die Funktion ein.
   3. Wählen Sie in der Liste Region eine Region aus.

4. Führen Sie im Bereich Trigger die folgenden Schritte aus:

   1. Wählen Sie in der Liste Triggertyp die Option HTTPS aus.

   2. Wählen Sie für die Authentifizierung Authentifizierung erforderlich aus.

      Weitere Informationen findest du unter Beim Aufruf authentifizieren (2. Generation).

5. Übernehmen Sie die anderen Standardeinstellungen und klicken Sie auf Next (Weiter).

6. Ändern Sie nicht die Standardlaufzeitsprache und den Beispielcode. Der Code verwendet keine Cloud-Dienste und es müssen keine zusätzlichen Berechtigungen aktiviert werden. Klicken Sie auf Bereitstellen.

7. Nachdem die Funktion erfolgreich bereitgestellt wurde, klicken Sie auf den Tab Trigger.

8. Kopieren Sie die HTTP-URL für die Funktion.

Cloud Scheduler-Job erstellen

Cloud Scheduler-Job erstellen, der eine Aktion über HTTP auslöst

1. Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler 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 des Jobs im Unix-Cron-Format an:

   30 16 * * 7
   

   Weitere Informationen finden Sie unter Format und Zeitzone von Cronjobs.

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 HTTP aus.

9. Geben Sie im Feld URL die HTTP-URL der Funktion ein, die Sie zuvor kopiert haben.

10. Wählen Sie in der Liste Auth-Header die Option OIDC-Token hinzufügen aus.

11. Wählen Sie in der Liste Dienstkonto das zuvor erstellte Dienstkonto aus.

12. Geben Sie im Feld Zielgruppe die HTTP-URL der Funktion ein, die Sie zuvor kopiert haben.

13. Klicken Sie auf Erstellen.

Sie haben einen Cronjob erstellt, der Ihre Cloud Functions-Funktion sonntags um 16:30 Uhr ausführt.

Cloud Scheduler-Job ausführen

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

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

   Zu Cloud Scheduler

2. Klicken Sie auf das Kästchen neben dem erstellten Job und dann 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 der Status der letzten Ausführung Success lauten.

Ergebnisse in Cloud Functions prüfen

Sie können prüfen, ob Ihre Cloud Functions-Funktion von Ihrem Cronjob erfolgreich ausgelöst und ausgeführt wird.

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Functions.

   Zu Cloud Functions

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.

   Sie sollten einen Logeintrag wie POST 200 146 B 5 ms Google-Cloud-Scheduler https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME sehen

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 Seite Cloud Scheduler 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 Seite Cloud Functions.

   Zu Cloud Functions

5. Klicken Sie das Kästchen neben der Funktion an.

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

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

   Zur Seite „Dienstkonten“

8. Klicken Sie auf das Kästchen neben dem von Ihnen erstellten Dienstkonto.

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

Nächste Schritte

• Cloud Run nach einem Zeitplan mit Cloud Scheduler auslösen