En esta página, se describe cómo crear listas de tareas en cola de Cloud Tasks. Cuando se agregan tareas a una cola, esta las envía y se asegura de que un servicio, también conocido como trabajador, las procese de manera confiable.
Ten en cuenta lo siguiente:
Los nombres de las colas constan de tres partes: un ID del proyecto, una ubicación y un ID de la cola. Debes tener un proyecto deGoogle Cloud que proporcione el ID del proyecto.
Si usas tareas de destino de App Engine, también debes tener una aplicación de App Engine ubicada en una región específica y en la que se ejecuten tu cola y tus controladores. Ten en cuenta la región cuando agregues la app.
El uso de tareas de destino HTTP no requiere una app de App Engine. Selecciona una Google Cloud ubicación cuando crees tu fila.
Crea una cola
Puedes crear una fila de las siguientes maneras:
- En la consola de Google Cloud
- Con Google Cloud CLI en tu terminal o Cloud Shell
- Envía una solicitud directa a la API de Cloud Tasks.
Console
En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.
Haz clic en
Crear fila.Ingresa un Nombre de cola, por ejemplo,
my-queue
.En la lista Región, selecciona una ubicación compatible en la que se ejecutará la cola, por ejemplo,
asia-south1
.Si tu organización restringe la ubicación de recursos y deseas crear tu cola en
us-central1
ous-central2
, la política de la organización debe permitir la creación de colas enus-central1
yus-central2
(incluso si solo necesitas una cola en una de esas regiones).De manera opcional, puedes configurar aún más tu fila.
Haz clic en Crear.
gcloud
Usa el comando gcloud tasks queues create
para crear tu cola:
gcloud tasks queues create QUEUE_ID \ --location=LOCATION
Reemplaza lo siguiente:
QUEUE_ID
: Es el identificador que asignas a tu fila, por ejemplo,my-queue
.LOCATION
: Una región compatible en la que se ejecutará la cola, por ejemplo,asia-south1
.Si tu organización restringe la ubicación de recursos y deseas crear tu cola en
us-central1
ous-central2
, la política de la organización debe permitir la creación de colas enus-central1
yus-central2
(incluso si solo necesitas una cola en una de esas regiones).
Otras marcas del comando de gcloud CLI te permiten configurar límites de frecuencia, opciones de reintento, tipos de colas y mucho más.
API de REST
Para crear una fila, usa el método projects.locations.queues.create
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
: Es el ID de tu proyecto de Google Cloud .LOCATION
: Una región compatible en la que se ejecutará la fila, por ejemplo,asia-south1
.Si tu organización restringe la ubicación de recursos y deseas crear tu cola en
us-central1
ous-central2
, la política de la organización debe permitir la creación de colas enus-central1
yus-central2
(incluso si solo necesitas una cola en una de esas regiones).QUEUE_ID
: El identificador que asignas a tu fila, por ejemplo,my-queue
.
Queue
incluyen límites de frecuencia, opciones de reintento, tipos de colas y mucho más.
Cuerpo JSON de la solicitud:
{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" }
Para enviar tu solicitud, expande una de estas opciones:
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de
Queue
:
{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "RUNNING" }
Pueden pasar varios minutos antes de que una cola recién creada esté disponible.
Describe tu fila
Puedes confirmar que tu cola se creó correctamente de las siguientes maneras:
- En la consola de Google Cloud
- Con gcloud CLI en tu terminal o Cloud Shell
Envía una solicitud directa a la API de Cloud Tasks.
Console
En la consola de Google Cloud , ve a la página Cloud Tasks > Colas.
Una marca de verificación verde
debería indicar que tu fila se está ejecutando.Para obtener más detalles, haz clic en el nombre de la cola y, luego, en la pestaña Configuración.
gcloud
Usa el comando gcloud tasks queues describe
para verificar que tu cola se haya creado correctamente:
gcloud tasks queues describe QUEUE_ID \ --location=LOCATION
Reemplaza lo siguiente:
QUEUE_ID
: ID de la fila (su nombre corto)LOCATION
: Es la ubicación de la fila.
El resultado debería ser similar al siguiente ejemplo:
name: projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID rateLimits: maxBurstSize: 100 maxConcurrentDispatches: 1000 maxDispatchesPerSecond: 500.0 retryConfig: maxAttempts: 100 maxBackoff: 3600s maxDoublings: 16 minBackoff: 0.100s state: RUNNING
API de REST
Para recuperar una fila, usa el método projects.locations.queues.get
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
: Es el ID de tu proyecto de Google Cloud .LOCATION
: la región en la que se implementa la cola, por ejemplo,us-central1
.QUEUE_ID
: ID corto de la fila, por ejemplo,my-queue
.
Para enviar tu solicitud, expande una de estas opciones:
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de
Queue
:
{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "RUNNING" }
Soluciona problemas relacionados con la creación de una fila
Si no ves el resultado esperado, puedes probar lo siguiente:
- Espera al menos un minuto mientras se inicializa la cola.
Asegúrate de que no haya una cola preexistente con el mismo ID. Puedes ver las colas de tu proyecto con el comando
gcloud tasks queues list
:gcloud tasks queues list \ --location=LOCATION
Para buscar en varias ubicaciones, debes realizar varias solicitudes.
Verifica si alcanzaste tu cuota de colas:
En la consola de Google Cloud , ve a la página API/Service Details de la API de Cloud Tasks .
Haz clic en la pestaña Cuotas y límites del sistema.
Para aumentar una cuota, en la fila correspondiente, haz clic en el ícono de elipsis > Editar cuota.
Para obtener más información, consulta Solicita un ajuste de cuota.
Vuelve a ejecutar los comandos para crear tu fila y asegúrate de que cada paso se complete correctamente.
¿Qué sigue?
- Configura colas de Cloud Tasks
- Referencia de la API de REST
- Referencia de la API de RPC
- Comandos de
gcloud
de Cloud Tasks