Bevor Sie ein Upgrade auf die neueste SDK-Version für App Engine-Dienste durchführen, lesen Sie die Übersicht über die Migration.
Sie können automatisch zu Cloud Tasks migrieren, indem Sie das App Engine Services SDK auf die aktuelle Version aktualisieren. Nach dem Upgrade leitet das SDK PushQueue-Aufrufe automatisch an die Cloud Tasks-Frontend-APIs weiter. Cloud Tasks behält Ihre vorhandenen Aufgabenwarteschlangen und Aufgaben bei, sodass keine zusätzliche Migration erforderlich ist.
Im Hintergrund verwendet das aktualisierte SDK die Cloud Tasks APIs, um die Funktionsparität mit den Task Queues-Funktionen aufrechtzuerhalten. Das SDK unterstützt Folgendes:
- Batch-Aufgabenerstellung: Das SDK verwendet Batch-APIs, um das Hinzufügen von bis zu 100 Aufgaben in einem einzigen Aufruf zu unterstützen.
- Batch-Aufgabenlöschung: Das SDK verwendet Batch-APIs,um das Löschen von bis zu 1.000 Aufgaben in einem einzigen Aufruf zu unterstützen.
- Wiederholungen auf Aufgabenebene: Das SDK unterstützt aufgabenspezifische Wiederholungskonfigurationen.
- Transaktionsaufgaben: Das SDK stellt Aufgaben in Datastore-Transaktionen in die Warteschlange. Erstellen oder ändern Sie die Datei
cron.yaml, um die Zuverlässigkeit zu gewährleisten.
Preise und Kontingente
Die Migration von Push-Warteschlangen zu Cloud Tasks kann sich auf die Preise und Kontingente für Ihre Anwendung auswirken.
Preise
Sehen Sie sich die Cloud Tasks-Preise an, um Ihre monatlichen Kosten vor der Migration zu schätzen.
Ähnlich wie bei Aufgabenwarteschlangen ist das Senden von Anfragen an Ihre App Engine-Anwendung mit einem Cloud Tasks-Push-Ziel kostenlos. Im Gegensatz zu Aufgabenwarteschlangen werden bei Cloud Tasks jedoch die ausgeführten Vorgänge wie das Erstellen, Löschen oder Verwalten von Aufgaben in Rechnung gestellt. Dies kann im Vergleich zur kostenlosen App Engine-Aufgabenwarteschlange zu höheren monatlichen Gesamtkosten führen.
Wenn Sie die Migration durch ein Upgrade des App Engine Services SDK durchführen und Ihre Anwendung transaktionale Aufgaben in Datastore-Transaktionen in die Warteschlange stellt, fallen für jede in die Warteschlange gestellte Aufgabe 3 Schreibvorgänge, 2 Lesevorgänge und 1 Löschvorgang in Datastore an, zusätzlich zur Standardabrechnung für die Cloud Tasks API.
Kontingente
Cloud Tasks-Anfragen werden auch auf Ihre App Engine-Anfragekontingente angerechnet.
Wie Aufgabenwarteschlangen hat auch Cloud Tasks dienstspezifische Kontingente. Durch die Migration zu Cloud Tasks ändern sich wahrscheinlich Ihre Kontingente.
Anfragelatenz optimieren
Da das aktualisierte SDK Anfragen direkt an die Cloud Tasks API sendet, kann das sequenzielle Einreihen oder Löschen einzelner Aufgaben die Anfragelatenz im Vergleich zum Legacy-Aufgabenwarteschlangendienst erhöhen. So minimieren Sie die Latenz:
- Mehrere Aufgaben in einem einzigen Aufruf zusammenfassen: Gruppieren Sie Aufgaben in Batch-Aufrufen zum Hinzufügen (bis zu 100 Aufgaben pro Aufruf) oder Batch-Aufrufen zum Löschen (bis zu 1.000 Aufgaben pro Aufruf), anstatt Aufgaben einzeln in einer Schleife in die Warteschlange zu stellen oder zu löschen.
- Asynchrone API-Aufrufe verwenden: Verwenden Sie nicht blockierende Methoden wie
add_async()unddelete_tasks_async(), damit die Verarbeitung von Anfragen nicht durch Taskvorgänge blockiert wird.
Hinweis
Führen Sie die folgenden Schritte aus, bevor Sie Push-Warteschlangen zu Cloud Tasks migrieren:
Sie benötigen Zugriff auf den App Engine-Quellcode.
Aktivieren Sie die Cloud Tasks API und die Cloud Scheduler API:
Bitten Sie Ihren Administrator, dem App Engine-Dienstkonto die IAM-Rolle Cloud Tasks-Warteschlangenersteller (
roles/cloudtasks.enqueuer) für das Projekt zuzuweisen, damit das Dienstkonto die erforderlichen Berechtigungen hat, um dem SDK das Senden von Aufgaben an die Cloud Tasks API zu ermöglichen.
App Engine Services SDK aktualisieren
Achten Sie darauf, dass Ihre Anwendung die aktuelle Version des App Engine-Dienste-SDK verwendet.
Aktualisieren Sie in der Datei
requirements.txtdie Abhängigkeitappengine-python-standardauf Version3.1.0oder höher und fügen Siegoogle-cloud-taskshinzu. Beispiel:Flask==3.0.0 appengine-python-standard>=3.1.0 google-cloud-tasks
Cloud Tasks-Routing aktivieren
runtime: python315 service: my-service-b env_variables: APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"Anwendung bereitstellen:
gcloud app deployRufen Sie in derGoogle Cloud Console die Seite „Cloud Tasks“ auf, um zu prüfen, ob Ihre Anwendung Cloud Tasks verwendet.
Transaktionale Aufgaben konfigurieren (optional)
Wenn Ihre Anwendung Aufgaben in Datastore-Transaktionen in die Warteschlange stellt, verwendet das SDK einen internen Cronjob, um sicherzustellen, dass alle Aufgaben, die während des Datastore-Commits nicht in die Warteschlange gestellt werden, schließlich verarbeitet werden.
Wenn Sie transaktionale Aufgaben in Push-Warteschlangen verarbeiten möchten, erstellen oder aktualisieren Sie die Datei cron.yaml, um den internen Prozessor regelmäßig aufzurufen. Beispiel:
cron:
- description: "Process push queue transactional tasks"
url: /_ah/cloudtask/sweep
schedule: every 30 minutes # Change this based on the usage pattern
Nächste Schritte
- Dokumentation zu Cloud Tasks
- Cloud Tasks-Clientbibliothek
- Cloud Tasks-REST-Referenz – Übersicht
- Cloud Tasks-RPC-Referenz – Übersicht
- Eine Anleitung finden Sie im Codelab zur Migration von App Engine Aufgaben-Push-Warteschlangen zu Cloud Tasks.