Auf dieser Seite wird beschrieben, wie Sie Cloud Tasks-Warteschlangen mit dem Befehl gcloud
der gcloud CLI erstellen.
Hinweis
Warteschlangennamen bestehen aus drei Teilen: einer Projekt-ID, einem Standort und einer Warteschlangen-ID. Für alle Zieltypen benötigen Sie ein Google Cloud-Projekt, das die Projekt-ID enthält.
Wenn Sie App Engine-Zielaufgaben verwenden, müssen Sie auch eine App Engine-Anwendung haben. Die Anwendung befindet sich in einer bestimmten Region und diese Region dient als Standortteil des Warteschlangennamens. Notieren Sie sich diesen Wert, wenn Sie die Anwendung hinzufügen. An diesem Ort werden Ihre Warteschlange und Ihre Handler ausgeführt.
Für HTTP Target-Aufgaben ist dagegen keine App Engine-Anwendung erforderlich. Sie wählen einen Google Cloud-Standort aus, wenn Sie Ihre Warteschlange erstellen.
Cloud Tasks-Warteschlange erstellen
Verwenden Sie zum Erstellen der Warteschlange das Google Cloud SDK:
gcloud tasks queues create QUEUE_ID --location=LOCATION_NAME
Dabei gilt:
LOCATION_NAME
: Der Standort, an dem die Warteschlange ausgeführt wird, z. B.europe-west4
.- Wenn Ihre Organisation den Ressourcenstandort beschränkt und Sie die Warteschlange in
us-central1
oderus-central2
erstellen möchten, muss die Organisationsrichtlinie das Erstellen von Warteschlangen inus-central1
undus-central2
zulassen (auch wenn Sie nur eine Warteschlange in einer dieser Regionen benötigen).
- Wenn Ihre Organisation den Ressourcenstandort beschränkt und Sie die Warteschlange in
QUEUE_ID
: Die Kennung, die Sie der Warteschlange zuweisen, z. B.my-queue
.
Es kann einige Minuten dauern, bis eine neu erstellte Warteschlange verfügbar ist. Prüfen Sie dann mit describe
, ob die Warteschlange erfolgreich erstellt wurde:
gcloud tasks queues describe QUEUE_ID
Die Ausgabe sollte etwa so aussehen:
name: projects/PROJECT_ID/locations/LOCATION_NAME/queues/QUEUE_ID rateLimits: maxBurstSize: 100 maxConcurrentDispatches: 1000 maxDispatchesPerSecond: 500.0 retryConfig: maxAttempts: 100 maxBackoff: 3600s maxDoublings: 16 minBackoff: 0.100s state: RUNNING
Wenn die vorherige 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. Sie können die Warteschlangen in Ihrem Projekt mit folgendem Aufruf aufrufen:
gcloud tasks queues list --location=LOCATION_NAME
Wenn Sie an mehreren Standorten suchen möchten, müssen Sie mehrere Anfragen stellen.
Prüfen Sie, ob Ihr Warteschlangenlimit erreicht ist:
Seite "Cloud Tasks API" aufrufen
Wählen Sie Kontingente aus.
Wenn Sie die Ressourcenlimits erhöhen möchten, wählen Sie in der Google Cloud Console auf der Seite „Kontingente“ die Option Kontingente bearbeiten aus.
Prüfen Sie alle Bestandteile des Befehls und führen Sie ihn noch einmal aus.
Nächste Schritte
- Cloud Tasks-Warteschlangen konfigurieren
- Weitere Informationen zur Warteschlangenverwaltung finden Sie in der Referenz zur RPC API.
- Weitere Informationen zur Warteschlangenverwaltung finden Sie in der Referenz zur REST API.
- Eine vollständige Liste der Cloud Tasks
gcloud
-Befehle