Cloud Scheduler-Schnellstart

In dieser Schnellstartanleitung werden Sie durch die folgenden grundlegenden Vorgänge mit Cloud Scheduler geführt:

  • Cloud Scheduler-Job erstellen
  • Wiederkehrenden Zeitplan für einen Job festlegen
  • Cloud Pub/Sub-Thema als Jobziel angeben
  • Job ausführen
  • Ergebnis prüfen

Cloud Scheduler hat ein kostenloses Kontingent. Die Ausführung dieser Schnellstartanleitung sollte daher keine Kosten verursachen. Weitere Informationen finden Sie unter Preise.

Vorbereitung

Folgen Sie den Anleitungen unten, um sich auf den Schnellstart vorzubereiten. Einige dieser Schritte haben Sie möglicherweise bereits ausgeführt.

gcloud-Befehlszeilentool installieren und konfigurieren:

  1. Installieren und initialisieren Sie das Cloud SDK.

  2. Fügen Sie die gcloud-Komponenten für Beta-Produkte hinzu:

     gcloud components install
    
  3. Aktualisieren Sie alle Komponenten:

     gcloud components update
    

Projekt mit einer App Engine-Anwendung erstellen

Alternativ können Sie ein bestehendes Projekt verwenden.

  1. Öffnen Sie auf dem Computer, auf dem das Cloud SDK installiert ist, ein Terminal und erstellen Sie ein GCP-Projekt:

     gcloud projects create [PROJECT_ID]
    

    Dabei steht PROJECT_ID für die ID des Projekts, das Sie erstellen möchten. Projekt-IDs müssen mit einem Kleinbuchstaben beginnen und können ASCII-Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Sie müssen zwischen 6 und 30 Zeichen lang sein.

  2. Konfigurieren Sie gcloud für die Verwendung des von Ihnen ausgewählten Projekts:

     gcloud config set project [PROJECT-ID]
    

    Dabei ist PROJECT_ID die ID, die Sie zuvor festgelegt haben.

  3. Erstellen Sie nun die Anwendung:

     gcloud app create [--region=REGION]
    

    Dabei ist [REGION] der Standort, an dem die Anwendung ausgeführt wird. Die zwei Standorte der App Engine-Befehle, europe-west und us-central, werden in den Cloud Tasks-Befehlen europe-west1 und us-central1 genannt.

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

     gcloud app describe
    

    Regionen werden nach locationId aufgeführt, z. B. locationId: us-central.

    Nachdem eine Zone für die App Engine-Anwendung festgelegt wurde, kann sie nicht mehr geändert werden.

Funktionen in der Google Cloud Platform Console aktivieren:

  1. Abrechnung für Ihr Projekt aktivieren

  2. Cloud Scheduler API aktivieren

  3. Cloud Pub/Sub API aktivieren

Cloud Pub/Sub mit gcloud einrichten:

  1. Richten Sie ein Cloud-Pub/Sub-Thema ein, das als Ziel für Ihren Cronjob gelten soll:

    gcloud pubsub topics create cron-topic
    

    Mit diesem Befehl wird ein Thema namens 'cron-topic' erstellt. Notieren Sie sich den Namen. Sie benötigen das Thema später in der Schnellstartanleitung.

  2. Erstellen Sie ein Cloud Pub/Sub-Abo, damit Sie die Ergebnisse Ihres Jobs ansehen und prüfen können.

    gcloud pubsub subscriptions create cron-sub --topic cron-topic
    

Job erstellen

  1. Gehen Sie in der Konsole zur Seite Cloud Scheduler:

    Cloud Scheduler

  2. Klicken Sie auf Create Job (Job erstellen).

  3. Geben Sie Ihrem Job einen Namen und fügen Sie optional unter "Description" eine Beschreibung hinzu.

    image

  4. Geben Sie unter Frequency Häufigkeit der Ausführung des Jobs im Format unix-cron an.

    * * * * *
    

    Weitere Informationen finden Sie unter Zeitpläne für Cronjobs konfigurieren. Entwickler, die mit dem Cron-Format von App Engine vertraut sind, können auch dieses verwenden.

  5. Wählen Sie Ihre Zeitzone unter "Timezone" aus.

  6. Wählen Sie im Feld Target (Ziel) aus dem Drop-down-Menü das Thema Pub/Sub aus und geben Sie unter "Topic" (Thema) das zuvor erstellte Thema cron-topic ein.

  7. Fügen Sie einen Payload-String hinzu, der an Ihr Cloud Pub/Sub-Ziel gesendet werden soll.

    image

  8. Klicken Sie auf Erstellen.

Sie haben einen Job erstellt, der jede Minute eine Nachricht an Ihr Cloud Pub/Sub-Thema sendet. Der Job kann jetzt ausgeführt werden.

Job ausführen

  1. Klicken Sie auf der Seite Cloud Scheduler, die mit Ihrem Projekt geöffnet wurde, auf Run now (Jetzt ausführen).

    Die Ausführung des ersten in einem Projekt erstellten Jobs kann aufgrund der erforderlichen Konfiguration beim ersten Aufruf einige Minuten dauern. Möglicherweise müssen Sie etwas warten.

  2. Sehen Sie sich die Ergebnisse in der Spalte Result (Ergebnis) an.

    image

Glückwunsch! Sie haben gerade in der Konsole die Ergebnisse eines Cronjobs aufgerufen. Der Job wurde ausgeführt, um eine Nachricht an Cloud Pub/Sub zu senden. Im nächsten Schritt prüfen Sie, ob Cloud Pub/Sub die Nachricht tatsächlich erhalten hat.

Ergebnisse in Cloud Pub/Sub prüfen

So überprüfen Sie, ob Ihr Cloud Pub/Sub-Thema Nachrichten von Ihrem Job empfängt:

  1. Führen Sie folgenden Befehl aus:

     gcloud pubsub subscriptions pull cron-sub --limit 5
    
  2. Rufen Sie die Ergebnisse auf. Die Ausgabe sollte in etwa so aussehen:

     +-------------+----------------+------------+-----------------------------+
     | DATA        | MESSAGE_ID     | ATTRIBUTES | ACK_ID                      |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56344662920621 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340561244339 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340388879975 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337745052761 |            | EkwnGERJUytDCypYEU4EISE...  |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337890896134 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
    

Bereinigen

So vermeiden Sie, dass Ihrem GCP-Konto die in dieser Schnellstartanleitung verwendeten Ressourcen in Rechnung gestellt werden:

Cloud Scheduler-Job löschen

  1. Öffnen Sie in der GCP Console die Seite Cloud Scheduler.

    Zur Seite "Scheduler"

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

  3. Klicken Sie oben auf der Seite auf Löschen und bestätigen Sie den Löschvorgang.

Pub/Sub-Thema löschen

  1. Wechseln Sie in der GCP Console zur Seite Cloud Pub/-Sub.

    Zur Seite "Pub/Sub"

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

  3. Klicken Sie oben auf der Seite auf Löschen und bestätigen Sie den Löschvorgang.

Projekt löschen

Löschen Sie das Projekt, das Sie nur für diesen Schnellstart erstellt haben.

  1. Wechseln Sie in der 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 Beenden, um das Projekt zu löschen.

Weitere Informationen