Push-Warteschlangen zu Cloud Tasks migrieren, indem Sie auf das neueste SDK aktualisieren (Java)

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 addAsync() und deleteTaskAsync(), 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:

  1. Sie benötigen Zugriff auf den App Engine-Quellcode.

  2. Aktivieren Sie die Cloud Tasks API und die Cloud Scheduler API:

    APIs aktivieren

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

  1. Achten Sie darauf, dass Ihre Anwendung die aktuelle Version des App Engine-Dienste-SDK verwendet.

    Aktualisieren Sie in Ihrer pom.xml das App Engine Services SDK auf Version 5.2.0 oder höher.

    <dependency>
        <groupId>com.google.appengine</groupId>
        <artifactId>appengine-api-1.0-sdk</artifactId>
        <version>5.2.0</version>
    </dependency>
  2. Cloud Tasks-Routing aktivieren

    runtime: java25
    service: my-service-b
    
    env_variables:
      APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"
    

    Aktualisieren Sie die App Engine SDK-Abhängigkeit in Ihrer pom.xml auf Version 5.2.0 oder höher.

    Wenn Ihre App eine XML-Konfiguration (appengine-web.xml) verwendet:

    <appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
      <service>my-java-service-b</service>
      <runtime>java25</runtime>
      <env-variables>
        <env-var name="APPENGINE_USE_CLOUDTASK_PUSH_QUEUE" value="true" />
      </env-variables>
    </appengine-web-app>
    
  3. Anwendung bereitstellen:

    gcloud app deploy
    
  4. Rufen 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

Fügen Sie in der Datei web.xml eine URL-Zuordnung für com.google.apphosting.utils.servlet.SweeperServlet oder com.google.apphosting.utils.servlet.jakarta.SweeperServlet für Java 17 und spätere Jakarta EE-Laufzeiten hinzu.

<servlet>
 <servlet-name>cloudtask_sweep</servlet-name>
 <servlet-class>com.google.apphosting.utils.servlet.SweeperServlet</servlet-class>
</servlet>
<servlet-mapping>
 <servlet-name>cloudtask_sweep</servlet-name>
 <url-pattern>/_ah/cloudtask/sweep</url-pattern>
</servlet-mapping>

Nächste Schritte