Umgebung einrichten

Bevor Sie einen Cronjob planen und ausführen, müssen Sie Ihr Google Cloud Projekt und Ihre Umgebung für Cloud Scheduler einrichten.

Cloud Scheduler API aktivieren

Folgen Sie der Anleitung, um ein Google Cloud Projekt zu erstellen oder auszuwählen und die Cloud Scheduler API zu aktivieren.

Console

  1. Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch keine Erfahrung mit Google Cloudhaben, erstellen Sie ein Konto, um zu sehen, wie sich unsere Produkte in realen Szenarien schlagen. 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.

    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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Scheduler API.

    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 API

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

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Scheduler API.

    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 API

    8.

gcloud

  1. Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch keine Erfahrung mit Google Cloudhaben, erstellen Sie ein Konto, um zu sehen, wie sich unsere Produkte in realen Szenarien schlagen. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. Installieren Sie die Google Cloud CLI.

  3. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  4. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  5. Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

    Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts

    • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können ein beliebiges Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
    • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die resourcemanager.projects.create Berechtigung enthält. Rollen zuweisen.

    • Erstellen Sie ein Google Cloud Projekt:

      gcloud projects create PROJECT_ID

      Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud Projekt, das Sie erstellen.

    • Wählen Sie das Google Cloud Projekt aus, das Sie erstellt haben:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

  6. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

  7. Aktivieren Sie die Cloud Scheduler API:

    Erforderliche Rollen zum Aktivieren von APIs

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) mit der serviceusage.services.enable Berechtigung. Rollen zuweisen. 

    gcloud services enable cloudscheduler.googleapis.com

  8. Installieren Sie die Google Cloud CLI.

  9. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  10. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  11. Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

    Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts

    • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können ein beliebiges Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
    • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die resourcemanager.projects.create Berechtigung enthält. Rollen zuweisen.

    • Erstellen Sie ein Google Cloud Projekt:

      gcloud projects create PROJECT_ID

      Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud Projekt, das Sie erstellen.

    • Wählen Sie das Google Cloud Projekt aus, das Sie erstellt haben:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

  12. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

  13. Aktivieren Sie die Cloud Scheduler API:

    Erforderliche Rollen zum Aktivieren von APIs

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) mit der serviceusage.services.enable Berechtigung. Rollen zuweisen. 

    gcloud services enable cloudscheduler.googleapis.com
    14.

Authentifizierung einrichten

Wie Sie sich bei Cloud Scheduler authentifizieren, hängt von der Schnittstelle ab, über die Sie auf die API zugreifen, und von der Umgebung, in der Ihr Code ausgeführt wird.

Weitere Informationen finden Sie unter Bei Cloud Scheduler authentifizieren und Authentifizierung mit HTTP-Zielen verwenden.

App Engine-Anwendung hinzufügen

Wenn Sie ein App Engine-HTTP-Ziel verwenden möchten, müssen Sie Ihrem Projekt eine App Engine-Anwendung hinzufügen. Diese Anwendung dient sowohl als Speicherort des Cloud Scheduler-Dienstes als auch des Job-Handlers selbst, der die mit einem Cloud Scheduler-Job verbundene Arbeit ausführt und eine Bestätigung zurückgibt.

Wenn Sie einen App Engine-Job-Handler verwenden möchten, der sich nicht in Ihrem Projekt befindet, sollten Sie stattdessen ein HTTP-Ziel auswählen. In diesem Fall benötigen Sie keine App Engine-Anwendung in Ihrem Projekt.

Console

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

    Zu App Engine

  2. Führen Sie im Dialogfeld Willkommen bei App Engine einen der folgenden Schritte aus:

    • Wenn Sie bereits eine App Engine-Anwendung erstellt haben und die Meldung Ihre App Engine-Anwendung wurde erstellt angezeigt wird, können Sie die restlichen Schritte in diesem Abschnitt überspringen.

      oder

    • Wenn Sie noch keine App Engine-Anwendung erstellt haben, klicken Sie auf Anwendung erstellen und fahren Sie mit den restlichen Schritten in diesem Abschnitt fort.

  3. Wählen Sie eine Region für Ihre Anwendung aus.

    Beachten Sie, dass europe-west und us-central in Cloud Scheduler-Befehlen als europe-west1 bzw. us-central1 bezeichnet werden.

    Nachdem Sie eine Region für die App Engine-Anwendung festgelegt haben, können Sie sie nicht mehr ändern it.

  4. Wählen Sie kein Dienstkonto aus. Das App Engine-Standarddienstkonto wird verwendet.

  5. Klicken Sie auf Weiter.

    Die Anwendung wird konfiguriert und erstellt. Dieser Vorgang kann einige Minuten dauern.

  6. Laden Sie das Cloud SDK nicht herunter, sondern klicken Sie auf Ich führe diesen Schritt später aus.

    Die Meldung Ihre App Engine-Anwendung wurde erstellt sollte angezeigt werden.

gcloud

  1. Führen Sie den gcloud app create Befehl aus, um eine App Engine-Anwendung zu erstellen:

    gcloud app create --region=REGION

    Ersetzen Sie REGION durch den Standort, an dem die Anwendung ausgeführt wird. Beachten Sie, dass europe-west bzw. us-central in Cloud Scheduler-Befehlen als europe-west1 bzw. us-central1 bezeichnet werden.

    Nachdem Sie eine Region für die App Engine-Anwendung festgelegt haben, können Sie sie nicht mehr ändern it.

  2. Sie können die Region einer vorhandenen Anwendung mit dem folgenden Befehl überprüfen:

    gcloud app describe

    Die locationId gibt die Region an. Beispiel: locationId: us-central.