Prima di eseguire l'upgrade all'ultima versione dell'SDK per i servizi App Engine, consulta la panoramica della migrazione.
Puoi eseguire la migrazione a Cloud Tasks automaticamente aggiornando l'SDK dei servizi App Engine all'ultima versione. Dopo l'upgrade, l'SDK reindirizza automaticamente le chiamate PushQueue alle API frontend di Cloud Tasks. Cloud Tasks conserva le code di attività e le attività esistenti, quindi non è necessaria alcuna migrazione aggiuntiva.
Dietro le quinte, l'SDK aggiornato utilizza le API Cloud Tasks per mantenere la parità delle funzionalità con quelle delle code di attività. L'SDK supporta quanto segue:
- Creazione di attività in batch: l'SDK utilizza le API batch per supportare l'aggiunta di un massimo di 100 attività in una singola chiamata.
- Eliminazione di attività in batch: l'SDK utilizza API batch per supportare l'eliminazione di un massimo di 1000 attività in una singola chiamata.
- Tentativi ripetuti a livello di attività: l'SDK supporta configurazioni di tentativi ripetuti specifiche per l'attività.
- Attività transazionali: l'SDK mette in coda le attività all'interno delle transazioni Datastore. Per mantenere l'affidabilità, crea o modifica il file
cron.yaml.
Prezzi e quote
La migrazione delle code in modalità push a Cloud Tasks potrebbe influire sui prezzi e sulle quote della tua app.
Prezzi
Consulta i prezzi di Cloud Tasks per stimare il costo mensile prima della migrazione.
Analogamente alle code di attività, l'invio di richieste alla tua app App Engine con un target push di Cloud Tasks è senza costi. Tuttavia, a differenza delle code di attività, Cloud Tasks addebita i costi per le operazioni eseguite, come la creazione, l'eliminazione o la gestione delle attività. Ciò potrebbe comportare un costo mensile complessivo più elevato rispetto alla coda di attività di App Engine senza costi.
Se esegui la migrazione eseguendo l'upgrade dell'SDK dei servizi App Engine e la tua applicazione inserisce in coda le attività transazionali all'interno delle transazioni Datastore, ogni attività in coda comporta 3 scritture, 2 letture e 1 eliminazione in Datastore oltre alla fatturazione standard dell'API Cloud Tasks.
Quote
Le richieste di Cloud Tasks vengono conteggiate anche ai fini delle quote delle richieste di App Engine.
Come le code di attività, Cloud Tasks ha quote specifiche per il servizio. La migrazione a Cloud Tasks probabilmente modificherà le tue quote.
Ottimizza la latenza delle richieste
Poiché l'SDK aggiornato invia richieste direttamente all'API Cloud Tasks, l'inserimento in coda o l'eliminazione di singole attività in sequenza può aumentare la latenza delle richieste rispetto al servizio di code di attività precedente. Per ridurre al minimo la latenza:
- Raggruppa più attività in un'unica chiamata: raggruppa le attività in chiamate di aggiunta in batch (fino a 100 attività per chiamata) o chiamate di eliminazione in batch (fino a 1000 attività per chiamata) anziché accodare o eliminare le attività una alla volta in un loop.
- Utilizza chiamate API asincrone: utilizza metodi non bloccanti come
addAsync()edeleteTaskAsync()in modo che le operazioni delle attività non blocchino la gestione delle richieste.
Prima di iniziare
Prima di eseguire la migrazione delle code in modalità push a Cloud Tasks, completa i seguenti passaggi:
Assicurati di avere accesso al codice sorgente di App Engine.
Abilita le API Cloud Tasks e Cloud Scheduler:
Per assicurarti che il account di servizio App Engine disponga delle autorizzazioni necessarie per consentire all'SDK di inviare attività all'API Cloud Tasks, chiedi all'amministratore di concedere il ruolo IAM Cloud Tasks Enqueuer (
roles/cloudtasks.enqueuer) al progetto.
Aggiorna l'SDK dei servizi App Engine
Assicurati che la tua applicazione utilizzi l'ultima versione dell'SDK dei servizi App Engine.
Nel tuo
pom.xml, aggiorna l'SDK dei servizi App Engine alla versione5.2.0o successiva.<dependency> <groupId>com.google.appengine</groupId> <artifactId>appengine-api-1.0-sdk</artifactId> <version>5.2.0</version> </dependency>
Abilita il routing di Cloud Tasks
runtime: java25 service: my-service-b env_variables: APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"Aggiorna la dipendenza dell'SDK App Engine nel tuo
pom.xmlalla versione5.2.0o successiva.Se la tua app utilizza una configurazione XML (
appengine-web.xml):<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>Esegui il deployment dell'app:
gcloud app deployPer verificare che la tua app utilizzi Cloud Tasks, vai alla pagina Cloud Tasks nella consoleGoogle Cloud .
(Facoltativo) Configura le attività transazionali
Se la tua app inserisce in coda le attività all'interno delle transazioni Datastore, l'SDK si basa su un cron job interno per garantire che le attività che non vengono inserite in coda durante il commit di Datastore vengano elaborate.
Per gestire le attività transazionali della coda in modalità push, crea o aggiorna il file cron.yaml per chiamare periodicamente il processore interno. Ad esempio:
cron:
- description: "Process push queue transactional tasks"
url: /_ah/cloudtask/sweep
schedule: every 30 minutes # Change this based on the usage pattern
Aggiungi una mappa URL nel file web.xml per
com.google.apphosting.utils.servlet.SweeperServlet o
com.google.apphosting.utils.servlet.jakarta.SweeperServlet per Java 17 e
runtime Jakarta EE successivi.
<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>
Passaggi successivi
- Documentazione di Cloud Tasks
- Libreria client di Cloud Tasks
- Panoramica del riferimento REST di Cloud Tasks
- Panoramica del riferimento RPC di Cloud Tasks