Auf dieser Seite wird beschrieben, wie Sie Cloud Tasks-Warteschlangen erstellen. Wenn einer Warteschlange Aufgaben hinzugefügt werden, werden sie von der Warteschlange weitergeleitet und von einem Dienst zuverlässig verarbeitet. Dieser Dienst wird auch als Worker bezeichnet.
Wichtige Hinweise:
Warteschlangennamen bestehen aus drei Teilen: einer Projekt-ID, einem Standort und einer Warteschlangen-ID. Sie benötigen ein Google Cloud-Projekt, das die Projekt-ID enthält.
Wenn Sie App Engine-Zielaufgaben verwenden, benötigen Sie auch eine App Engine-Anwendung, die sich in einer bestimmten Region befindet und in der die Warteschlange und die Handler ausgeführt werden. Notieren Sie sich die Region, wenn Sie die App hinzufügen.
Für die Verwendung von HTTP-Zielaufgaben ist keine App Engine-Anwendung erforderlich. Sie wählen beim Erstellen der Warteschlange einen Google Cloud Speicherort aus.
Warteschlange erstellen
Sie haben folgende Möglichkeiten, eine Warteschlange zu erstellen:
- In der Google Cloud Console
- Über die Google Cloud CLI in Ihrem Terminal oder in Cloud Shell
- Durch Senden einer direkten Anfrage an die Cloud Tasks API
Console
Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.
Klicken Sie auf
Warteschlange erstellen.Geben Sie einen Warteschlangennamen ein, z. B.
my-queue
.Wählen Sie in der Liste Region einen unterstützten Speicherort aus, an dem die Warteschlange ausgeführt werden soll, z. B.
asia-south1
.Wenn Ihre Organisation Ressourcenstandorte einschränkt und Sie die Warteschlange in
us-central1
oderus-central2
erstellen möchten, muss die Organisationsrichtlinie die Erstellung von Warteschlangen sowohl inus-central1
als auch inus-central2
zulassen, auch wenn Sie nur eine Warteschlange in einer dieser Regionen benötigen.Optional können Sie die Warteschlange weiter konfigurieren.
Klicken Sie auf Erstellen.
gcloud
Erstellen Sie die Warteschlange mit dem Befehl gcloud tasks queues create
:
gcloud tasks queues create QUEUE_ID \ --location=LOCATION
Ersetzen Sie Folgendes:
QUEUE_ID
: die Kennzeichnung, die Sie der Warteschlange zuweisen, z. B.my-queue
.LOCATION
: Eine unterstützte Region, in der die Warteschlange ausgeführt wird, z. B.asia-south1
.Wenn Ihre Organisation den Speicherort von Ressourcen einschränkt und Sie die Warteschlange in
us-central1
oderus-central2
erstellen möchten, muss die Organisationsrichtlinie die Erstellung von Warteschlangen sowohl inus-central1
als auch inus-central2
zulassen, auch wenn Sie nur eine Warteschlange in einer dieser Regionen benötigen.
Mit anderen Flags für den gcloud-Befehl können Sie unter anderem Ratenlimits, Wiederholungsoptionen und Warteschlangentypen konfigurieren.
REST API
Verwenden Sie zum Erstellen einer Warteschlange die Methode projects.locations.queues.create
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist Ihre Google Cloud-Projekt-ID.LOCATION
: Eine unterstützte Region, in der die Warteschlange ausgeführt wird, z. B.asia-south1
.Wenn Ihre Organisation den Ressourcenstandort einschränkt und Sie die Warteschlange entweder in
us-central1
oderus-central2
erstellen möchten, muss die Organisationsrichtlinie die Erstellung von Warteschlangen sowohl inus-central1
als auch inus-central2
zulassen, auch wenn Sie nur eine Warteschlange in einer dieser Regionen benötigen.QUEUE_ID
: Die Kennzeichnung, die Sie der Warteschlange zuweisen, z. B.my-queue
.
Queue
-Ressource gehören unter anderem Ratenlimits, Wiederholungsoptionen und Warteschlangentypen.
JSON-Text der Anfrage:
{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Queue
.
{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "RUNNING" }
Es kann einige Minuten dauern, bis eine neu erstellte Warteschlange verfügbar ist.
Wiedergabeliste beschreiben
So können Sie prüfen, ob die Warteschlange erfolgreich erstellt wurde:
- In der Google Cloud Console
- Über die gcloud CLI in Ihrem Terminal oder in Cloud Shell
Durch Senden einer direkten Anfrage an die Cloud Tasks API
Console
Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.
Ein grünes Häkchen
sollte anzeigen, dass die Warteschlange ausgeführt wird.Klicken Sie auf den Namen der Warteschlange und dann auf den Tab Konfiguration, um weitere Informationen aufzurufen.
gcloud
Verwenden Sie den Befehl gcloud tasks queues describe
, um zu prüfen, ob die Warteschlange erfolgreich erstellt wurde:
gcloud tasks queues describe QUEUE_ID \ --location=LOCATION
Ersetzen Sie Folgendes:
QUEUE_ID
: die Warteschlangen-ID (kurzer Name)LOCATION
: Speicherort der Warteschlange
Die Ausgabe sollte in etwa so aussehen:
name: projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID rateLimits: maxBurstSize: 100 maxConcurrentDispatches: 1000 maxDispatchesPerSecond: 500.0 retryConfig: maxAttempts: 100 maxBackoff: 3600s maxDoublings: 16 minBackoff: 0.100s state: RUNNING
REST API
Verwenden Sie die Methode projects.locations.queues.get
, um eine Warteschlange abzurufen.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist Ihre Google Cloud-Projekt-ID.LOCATION
: die Region, in der die Warteschlange bereitgestellt wird, z. B.us-central1
.QUEUE_ID
: die Kurz-ID der Warteschlange, z. B.my-queue
.
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Queue
:
{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "RUNNING" }
Fehlerbehebung beim Erstellen einer Warteschlange
Wenn die erwartete Ausgabe nicht angezeigt wird, können Sie Folgendes versuchen:
- Warten Sie mindestens eine Minute, bis die Warteschlange initialisiert wurde.
Prüfen Sie, dass noch keine Warteschlange mit der gleichen ID existiert. Mit dem Befehl
gcloud tasks queues list
können Sie die Warteschlangen in Ihrem Projekt aufrufen:gcloud tasks queues list \ --location=LOCATION
Wenn Sie an mehreren Orten suchen möchten, müssen Sie mehrere Anfragen stellen.
Prüfen Sie, ob Ihr Warteschlangenkontingent erreicht ist:
Rufen Sie in der Google Cloud Console die Seite API-/Dienstdetails für die Cloud Tasks API auf .
Klicken Sie auf den Tab Kontingente und Systemlimits.
Wenn Sie ein Kontingent erhöhen möchten, klicken Sie in der Zeile für das Kontingent auf das Dreipunkt-Menü > Kontingent bearbeiten.
Weitere Informationen finden Sie unter Höheren Kontingentwert anfordern.
Führen Sie die Befehle zum Erstellen der Warteschlange noch einmal aus und achten Sie darauf, dass jeder Schritt korrekt ausgeführt wird.
Nächste Schritte
- Cloud Tasks-Warteschlangen konfigurieren
- REST API-Referenz
- RPC API-Referenz
gcloud
-Befehle für Cloud Tasks