Crear colas para tareas extraídas

En esta página se describe cómo crear una cola de extracción. Debes crear la cola antes de poder añadirle tareas. En la página también se explica cómo pausar o eliminar una cola.

Esta API es compatible con los tiempos de ejecución de primera generación y se puede usar al actualizar a los tiempos de ejecución de segunda generación correspondientes. Si vas a actualizar al tiempo de ejecución de App Engine Go 1.12 o una versión posterior, consulta la guía de migración para obtener información sobre las opciones de migración de los servicios empaquetados antiguos.

Definir colas con queue.yaml

Puedes definir colas para tareas extraídas con el archivo queue.yaml de tu aplicación. El proceso es el mismo que el de crear colas de inserción con nombre, con una directiva especializada, mode: pull, añadida al archivo.

queue:
- name: my-queue-name
  mode: pull

Para subir el archivo, usa el comando gcloud de gcloud CLI.

gcloud app deploy queue.yaml

Nota: Si usas una cuenta de servicio para gestionar la autenticación al implementar tu archivo de configuración de colas, debe tener el permiso serviceusage.services.list. Este permiso se puede añadir mediante el rol serviceusage.serviceUsageViewer o creando un rol personalizado con ese permiso.

Precaución: La creación de colas para el servicio de colas de tareas también se puede gestionar mediante los métodos de gestión de colas disponibles directamente a través de la API Cloud Tasks, pero combinar el método de subida queue.yaml con los métodos de gestión de colas puede dar resultados inesperados, por lo que no se recomienda. Para obtener más información, consulta Descripción general de la gestión de colas y queue.yaml. Ten en cuenta también que, si subes un archivo queue.yaml mediante gcloud CLI con una versión anterior a 332.0.0, se usará una interfaz obsoleta del servicio. A partir del 2022-09-20, los intentos de usar el método de subida pueden fallar y mostrar errores del servidor. Para solucionar este problema, asegúrese de que la API Cloud Tasks esté habilitada en su proyecto y de que su CLI de gcloud esté actualizada al menos a la versión 332.0.0.

Inhabilitar colas

Para inhabilitar o pausar una cola, elimina su definición del archivo de configuración de la cola y, a continuación, sube el archivo actualizado.

Una vez que se haya subido el archivo actualizado, la cola se inhabilitará y su frecuencia se establecerá en 0. Las tareas que estén en la cola o las nuevas tareas que se añadan a la cola no se procesarán. Para volver a habilitar la cola inhabilitada, sube un nuevo archivo de cola con la cola definida.

También puedes pausar una cola desde la página Cloud Tasks de la Google Cloud consola.

Eliminar colas

Para eliminar una cola, primero debes inhabilitarla:

1. Elimina la definición de la cola del archivo de configuración de la cola.

2. Sube el archivo modificado.

   gcloud app deploy queue.yaml
   

Una vez que la cola esté inhabilitada, usa la Google Cloud consola para eliminarla.

1. En la Google Cloud consola, selecciona la cola.

   Ir a Cloud Tasks

2. Haz clic en Eliminar cola.

Si eliminas una cola de la Google Cloud consola, debes esperar 7 días para volver a crearla con el mismo nombre.

Importante: El servidor de desarrollo local (dev_appserver) no admite colas de extracción. Para probar tus colas de extracción y asegurarte de que los detalles de tu configuración son correctos, debes enviar tu archivo de configuración de colas a un entorno de staging de App Engine.

Siguientes pasos

Consulta cómo crear tareas.