HTTP-Cloud Run-Funktion planen

In dieser Anleitung wird gezeigt, wie Sie eine HTTP-Cloud Run-Funktion planen, indem Sie in Cloud Scheduler einen HTTP-Endpunkt 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.

Wenn Sie eine CloudEvents-Funktion erstellt haben, können Sie Eventarc-Ereignistrigger verwenden, um die Reaktion Ihrer Funktion auf Ereignisse in Ihrem Projekt zu planen. Eventarc kann Nachrichten in einem Pub/Sub-Thema, Änderungen in einem Cloud Storage-Bucket und vieles mehr auslösen. Weitere Informationen finden Sie unter Typen 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. Einfache HTTP-Cloud Run Functions-Funktion erstellen
2. Cloud Scheduler-Job erstellen
3. Cloud Scheduler-Job ausführen
4. Prüfen, ob der Cloud Scheduler-Job Ihre Cloud Run-Funktion auslöst

Kosten

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

• Cloud Run
• Cloud Scheduler

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.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Enable the APIs

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 following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click add Add another role and add each additional role.

6. Click Continue.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Enable the APIs

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 following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click add Add another role and add each additional role.

6. Click Continue.

7. Click Done to finish creating the service account.

Sie müssen die Rolle „Cloud Run Invoker“ gewähren, da in Cloud Run-Funktionen Aufrufberechtigungen durch die Verwaltung des zugrunde liegenden Cloud Run-Dienstes verfügbar sind.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen der Anleitung benötigen:

• Cloud Run Source Developer (roles/run.sourceDeveloper)
• Cloud Scheduler-Administrator (roles/cloudscheduler.admin)
• Zugriffsberechtigter für Logbetrachtung (roles/logging.viewAccessor)
• Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin)
• Service Account Admin (roles/iam.serviceAccountAdmin)
• Dienstkontonutzer (roles/iam.serviceAccountUser)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Rollen zuweisen

Console

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

   IAM aufrufen
2. Wählen Sie das Projekt aus.
3. Klicken Sie auf person_add Zugriff erlauben.

4. Geben Sie im Feld Neue Hauptkonten Ihre Nutzer-ID ein. Dies ist in der Regel die E-Mail-Adresse des Google-Kontos, mit dem der Cloud Run-Dienst bereitgestellt wird.

5. Wählen Sie in der Liste Rolle auswählen eine Rolle aus.
6. Wenn Sie weitere Rollen zuweisen möchten, klicken Sie auf add Weitere Rolle hinzufügen und fügen Sie weitere Rollen hinzu.
7. Klicken Sie auf Speichern.

gcloud

So weisen Sie Ihrem Konto die erforderlichen IAM-Rollen für Ihr Projekt zu:

     gcloud projects add-iam-policy-binding PROJECT_ID \
         --member=PRINCIPAL \
         --role=ROLE
     

Ersetzen Sie:

• PROJECT_NUMBER durch Ihre Google Cloud Projektnummer.
• PROJECT_ID durch Ihre Google Cloud Projekt-ID.
• PRINCIPAL durch das Konto, für das Sie die Bindung hinzufügen. Dies ist in der Regel die E-Mail-Adresse des Google-Kontos, mit dem der Cloud Run-Dienst bereitgestellt wird.
• ROLE durch die Rolle, die Sie dem Bereitstellerkonto hinzufügen.

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

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

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 delete Löschen und bestätigen Sie den Löschvorgang.

4. Rufen Sie in der Google Cloud -Console die Seite Cloud Run auf.

   Zu Cloud Run

5. Klicken Sie das Kästchen neben dem Dienst an.

6. Klicken Sie auf delete 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. Aktivieren Sie das Kästchen neben dem von Ihnen erstellten Dienstkonto.

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

Nächste Schritte

• Cloud Scheduler zum Auslösen von Cloud Run nach Zeitplan verwenden
• Schreiben Sie CloudEvents-Funktionen, um festzulegen, dass Ihre Funktion auf Ereignisse in Ihrem Projekt reagiert.