Antes de actualizar a la versión más reciente del SDK de servicios de App Engine, revisa la descripción general de la migración.
Puedes migrar a Cloud Tasks de forma automática si actualizas el SDK de servicios de App Engine a la versión más reciente. Después de la actualización, el SDK
redirecciona automáticamente las llamadas de PushQueue a las APIs de frontend de Cloud Tasks. Cloud Tasks conserva tus listas de tareas en cola
y tareas existentes, por lo que no se requiere ninguna migración adicional.
Tras bambalinas, el SDK actualizado usa las APIs de Cloud Tasks para mantener la paridad de funciones con las de las listas de tareas en cola. El SDK admite lo siguiente:
- Creación de tareas por lotes: El SDK usa APIs por lotes para admitir la adición de hasta 100 tareas en una sola llamada.
- Borrado de tareas por lotes: El SDK usa APIs por lotes para admitir la eliminación de hasta 1,000 tareas en una sola llamada.
- Reintentos a nivel de la tarea: El SDK admite parámetros de configuración de reintentos específicos de la tarea.
- Tareas transaccionales: El SDK agrega tareas en cola dentro de las transacciones de
Datastore. Para mantener la confiabilidad, crea o modifica el
archivo
cron.yaml.
Precios y cuotas
Migrar las listas de aplicaciones en cola a Cloud Tasks puede afectar los precios y las cuotas de tu app.
Precios
Revisa los precios de Cloud Tasks para estimar tu costo mensual antes de migrar.
Al igual que con las listas de tareas en cola, el envío de solicitudes a tu app de App Engine con un destino de envío de Cloud Tasks es gratuito. Sin embargo, a diferencia de las listas de tareas en cola, Cloud Tasks cobra por las operaciones realizadas, como crear, borrar o administrar tareas. Esto podría generar un costo mensual general más alto en comparación con la lista de tareas en cola de App Engine complementaria.
Si migras mediante la actualización del SDK de servicios de App Engine y tu aplicación coloca en cola tareas transaccionales dentro de las transacciones de Datastore, cada tarea en cola genera 3 escrituras, 2 lecturas y 1 eliminación en Datastore, además de la facturación estándar de la API de Cloud Tasks.
Cuotas
Las solicitudes de Cloud Tasks también se tienen en cuenta en las cuotas de solicitudes de App Engine.
Al igual que las listas de tareas en cola, Cloud Tasks tiene cuotas específicas del servicio. Es probable que la migración a Cloud Tasks cambie tus cuotas.
Optimiza la latencia de las solicitudes
Debido a que el SDK actualizado envía solicitudes directamente a la API de Cloud Tasks, agregar o borrar tareas individuales de forma secuencial puede aumentar la latencia de las solicitudes en comparación con el servicio heredado de listas de tareas en cola. Para minimizar la latencia, haz lo siguiente:
- Agrupa varias tareas en una sola llamada: Agrupa las tareas en llamadas de adición por lotes (hasta 100 tareas por llamada) o llamadas de eliminación por lotes (hasta 1,000 tareas por llamada) en lugar de poner en cola o borrar tareas una por una en un bucle.
- Usa llamadas a la API asíncronas: Usa métodos sin bloqueo, como
add_async()ydelete_tasks_async(), para que las operaciones de tareas no bloqueen el control de solicitudes.
Antes de comenzar
Completa los siguientes pasos antes de migrar las listas de aplicaciones en cola a Cloud Tasks:
Asegúrate de tener acceso al código fuente de App Engine.
Habilita las APIs de Cloud Tasks y Cloud Scheduler:
Para asegurarte de que la cuenta de servicio de App Engine tenga los permisos necesarios para permitir que el SDK envíe tareas a la API de Cloud Tasks, pídele a tu administrador que otorgue el rol de IAM de Agregador de tareas a la cola de Cloud Tasks (
roles/cloudtasks.enqueuer) en el proyecto.
Actualiza el SDK de servicios de App Engine
Asegúrate de que tu aplicación use la versión más reciente del SDK de servicios de App Engine.
En tu archivo
requirements.txt, actualiza la dependenciaappengine-python-standarda la versión3.1.0o una posterior, y agregagoogle-cloud-tasks. Por ejemplo:Flask==3.0.0 appengine-python-standard>=3.1.0 google-cloud-tasks
Habilita el enrutamiento de Cloud Tasks
runtime: python315 service: my-service-b env_variables: APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"Implementa tu app con el siguiente comando:
gcloud app deployPara verificar que tu app use Cloud Tasks, ve a la página de Cloud Tasks en la consola deGoogle Cloud .
Configura tareas transaccionales (opcional)
Si tu app pone en cola tareas dentro de transacciones de Datastore, el SDK depende de un trabajo cron interno para garantizar que las tareas que no se pongan en cola durante la confirmación del almacén de datos se procesen con el tiempo.
Para controlar las tareas transaccionales de la lista de aplicaciones en cola, crea o actualiza tu archivo cron.yaml para llamar al procesador interno de forma periódica. Por ejemplo:
cron:
- description: "Process push queue transactional tasks"
url: /_ah/cloudtask/sweep
schedule: every 30 minutes # Change this based on the usage pattern
¿Qué sigue?
- Documentación de Cloud Tasks
- Biblioteca cliente de Cloud Tasks
- Descripción general de la referencia de REST de Cloud Tasks
- Descripción general de la referencia de RPC de Cloud Tasks
- Para ver un instructivo, consulta el Migra listas de aplicaciones en cola de la lista de tareas en cola de App Engine a codelab de Cloud Tasks.