Cloud Tasks-Warteschlangen erstellen

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, auch Worker genannt, zuverlässig verarbeitet.

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

• Wenn Sie App Engine-Zielaufgaben verwenden, benötigen Sie auch eine App Engine-Anwendung , die sich in einer bestimmten Region befindet und in der Ihre Warteschlange und Ihre Handler ausgeführt werden. Notieren Sie sich die Region, wenn Sie die App hinzufügen.

  Hinweis: Zwei Speicherorte, die in App Engine-Befehlen europe-west und us-central genannt werden, werden in Cloud Tasks-Befehlen europe-west1 und us-central1 genannt.

• Für HTTP-Zielaufgaben ist keine App Engine-Anwendung erforderlich. Sie wählen einen Google Cloud Speicherort aus, wenn Sie Ihre Warteschlange erstellen.

Warteschlange erstellen

Sie haben folgende Möglichkeiten, eine Warteschlange zu erstellen:

• In der Google Cloud Console
• Mit der Google Cloud CLI entweder in Ihrem Terminal oder in Cloud Shell
• Durch Senden einer direkten Anfrage an die Cloud Tasks API

Hinweis: Wenn Sie das Routing für eine App Engine-Warteschlange konfigurieren und den Zieldienst, der den entsprechenden Worker enthält, nicht explizit festlegen, wird der Standarddienst verwendet. Weitere Informationen finden Sie unter Cloud Tasks-Warteschlangen konfigurieren.

Console

1. Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

   Zu „Warteschlangen“

2. Klicken Sie auf Warteschlange erstellen.

3. Geben Sie einen Warteschlangennamen ein, z. B. my-queue.

4. Wählen Sie in der Liste Region einen unterstützten Standort aus, an dem die Warteschlange ausgeführt werden soll, z. B. asia-south1.

   Wenn Ihre Organisation den Ressourcenstandort einschränkt und Sie Ihre Warteschlange in us-central1 oder us-central2 erstellen möchten, muss die Organisationsrichtlinie die Erstellung von Warteschlangen in beiden Regionen zulassen, us-central1 und us-central2 (auch wenn Sie nur eine Warteschlange in einer dieser Regionen benötigen).

5. Optional können Sie die Warteschlange weiter konfigurieren.

6. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie den gcloud tasks queues create Befehl, um Ihre Warteschlange zu erstellen:

  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 Ressourcenstandort einschränkt und Sie Ihre Warteschlange in us-central1 oder us-central2 erstellen möchten, muss die Organisationsrichtlinie die Erstellung von Warteschlangen in beiden Regionen zulassen, us-central1 und us-central2 (auch wenn Sie nur eine Warteschlange in einer dieser Regionen benötigen).

Mit anderen Flags für den gcloud CLI-Befehl können Sie Ratenlimits, Wiederholungsoptionen, Warteschlangentypen und mehr konfigurieren.

REST API

Verwenden Sie zum Erstellen einer Warteschlange die projects.locations.queues.create Methode.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: 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 Ihre Warteschlange in entweder us-central1 oder us-central2 erstellen möchten, muss die Organisationsrichtlinie die Erstellung von Warteschlangen in beiden us-central1 und us-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.

Weitere konfigurierbare Eigenschaften für die Queue Ressource sind Ratenlimits, Wiederholungsoptionen, Warteschlangentypen und mehr.

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:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
EOF

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

@'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

APIs Explorer (Browser)

Kopieren Sie den Anfragetext und öffnen Sie die Referenzseite für Methoden. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Fügen Sie den Anfragetext in dieses Tool ein, füllen Sie alle Pflichtfelder aus und klicken Sie auf Ausführen.

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.

Warteschlange beschreiben

So können Sie prüfen, ob Ihre Warteschlange erfolgreich erstellt wurde:

• In der Google Cloud Console
• Mit der gcloud CLI entweder in Ihrem Terminal oder in Cloud Shell

• Durch Senden einer direkten Anfrage an die Cloud Tasks API

Console

1. Rufen Sie in der Google Cloud Console die Seite Cloud Tasks > Warteschlangen auf.

   Zu „Warteschlangen“

   Ein grünes Häkchen sollte anzeigen, dass Ihre Warteschlange ausgeführt wird.

2. Klicken Sie für weitere Informationen auf den Namen der Warteschlange und dann auf den Tab Konfiguration.

gcloud

Prüfen Sie mit dem gcloud tasks queues describe Befehl, ob die Warteschlange erfolgreich erstellt wurde:

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Ersetzen Sie Folgendes:

• QUEUE_ID: die Warteschlangen-ID (Kurzname)
• LOCATION: der Standort 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 zum Abrufen einer Warteschlange die projects.locations.queues.get Methode.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: 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:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

APIs Explorer (Browser)

Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

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

Hinweis: Das Logging für Ihre Warteschlange ist nicht standardmäßig aktiviert. Informationen zum Aktivieren des Loggings finden Sie unter Cloud Logging mit Warteschlangen verwenden.

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 Standorten suchen möchten, müssen Sie mehrere Anfragen senden.

• Prüfen Sie, ob Sie Ihr Warteschlangenkontingent erreicht haben:

  1. Rufen Sie in der Google Cloud Console die Seite API-/Dienstdetails für die Cloud Tasks API auf.

     Zu „API-/Dienstdetails“

  2. Klicken Sie auf den Tab Kontingente und Systemlimits.

  3. 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 Kontingentanpassung anfordern.

• Führen Sie die Befehle zum Erstellen der Warteschlange noch einmal aus und prüfen Sie, ob jeder Schritt korrekt ausgeführt wurde.

Nächste Schritte

• Cloud Tasks-Warteschlangen konfigurieren
• REST API-Referenz
• RPC API-Referenz
• gcloud-Befehle für Cloud Tasks