Crear colas de Cloud Tasks

En esta página se describe cómo crear colas de Cloud Tasks. Cuando se añaden tareas a una cola, esta las envía y se asegura de que un servicio, también conocido como trabajador, las procese de forma fiable.

Ten en cuenta lo siguiente:

• Los nombres de las colas constan de tres partes: un ID de proyecto, una ubicación y un ID de cola. Debes tener un Google Cloud proyecto que proporcione el ID de 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, que es donde se ejecutan tu cola y tus controladores. Ten en cuenta la región al añadir la aplicación.

  Nota: En los comandos de App Engine, hay dos ubicaciones llamadas europe-west y us-central, que se denominan europe-west1 y us-central1, respectivamente, en los comandos de Cloud Tasks.

• Para usar tareas de destino HTTP, no es necesario tener una aplicación de App Engine. Cuando creas una cola, seleccionas una Google Cloud ubicación.

Crea una cola

Puedes crear una cola de las siguientes formas:

• En la Google Cloud consola
• Usando la CLI de Google Cloud en tu terminal o en Cloud Shell
• Enviando una solicitud directa a la API Cloud Tasks

Nota: Si estás configurando el enrutamiento de una cola de App Engine y no defines explícitamente el servicio de destino que contiene el trabajador adecuado, se usará el servicio predeterminado. Para obtener más información, consulta Configurar colas de Cloud Tasks.

Consola

1. En la Google Cloud consola, ve a la página Cloud Tasks > Colas.

   Ir a Colas

2. Haz clic en Crear cola.

3. Introduce un nombre de cola; por ejemplo, my-queue.

4. En la lista Región, selecciona una ubicación admitida en la que se ejecutará la cola (por ejemplo, asia-south1).

   Si tu organización restringe la ubicación de los recursos y quieres crear una cola en us-central1 o us-central2, la política de la organización debe permitir la creación de colas en ambas regiones (aunque solo necesites una cola en una de ellas).us-central1us-central2

5. También puedes configurar tu cola.

6. Haz clic en Crear.

gcloud

Usa el comando gcloud tasks queues create para crear la cola:

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Haz los cambios siguientes:

• QUEUE_ID: el identificador que asignas a tu cola, por ejemplo, my-queue.

• LOCATION: una región admitida en la que se ejecutará la cola. Por ejemplo, asia-south1.

  Si tu organización restringe la ubicación de los recursos y quieres crear una cola en us-central1 o us-central2, la política de la organización debe permitir la creación de colas en ambas regiones (aunque solo necesites una cola en una de ellas).us-central1us-central2

Otras marcas del comando de la CLI de gcloud te permiten configurar límites de frecuencia, opciones de reintento, tipos de colas y más.

API REST

Para crear una cola, usa el método projects.locations.queues.create.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: tu ID de proyecto Google Cloud .
• LOCATION: una región admitida en la que se ejecutará la cola. Por ejemplo, asia-south1.

  Si tu organización restringe la ubicación de los recursos y quieres crear tu cola en us-central1 o us-central2, la política de la organización debe permitir la creación de colas en us-central1 y us-central2 (aunque solo necesites una cola en una de esas regiones).

• QUEUE_ID: el identificador que asignes a tu cola (por ejemplo, my-queue).

Otras propiedades configurables del recurso Queue incluyen límites de frecuencia, opciones de reintento, tipos de colas y más.

Cuerpo JSON de la solicitud:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
EOF

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues"

PowerShell (Windows)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:

@'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

A continuación, ejecuta el siguiente comando para enviar tu solicitud REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

Explorador de APIs (navegador)

Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel APIs Explorer se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, rellena los campos obligatorios y haz clic en Ejecutar.

Si la solicitud se completa correctamente, 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"
}

Una cola creada recientemente puede tardar unos minutos en estar disponible.

Describe tu cola

Puedes confirmar que la cola se ha creado correctamente de las siguientes formas:

• En la Google Cloud consola
• Usando la CLI gcloud en tu terminal o en Cloud Shell

• Enviando una solicitud directa a la API Cloud Tasks

Consola

1. En la Google Cloud consola, ve a la página Cloud Tasks > Colas.

   Ir a Colas

   Una marca de verificación verde debería indicar que tu cola está en funcionamiento.

2. Para obtener más información, haga clic en el nombre de la cola y, a continuación, en la pestaña Configuración.

gcloud

Usa el comando gcloud tasks queues describe para verificar que la cola se ha creado correctamente:

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Haz los cambios siguientes:

• QUEUE_ID: el ID de la cola (su nombre abreviado)
• LOCATION: la ubicación de la cola

La salida debería ser similar a la siguiente:

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 REST

Para recuperar una cola, utiliza el método projects.locations.queues.get.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: tu ID de proyecto Google Cloud .
• LOCATION: la región en la que se implementa la cola. Por ejemplo, us-central1.
• QUEUE_ID: el ID corto de la cola, por ejemplo, my-queue.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell (Windows)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

Explorador de APIs (navegador)

Abre la página de referencia del método. El panel APIs Explorer se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.

Si la salida del comando es correcta, en el cuerpo de la respuesta se incluirá 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"
}

Solucionar problemas al crear una cola

Nota: El registro de tu cola no está habilitado de forma predeterminada. Para obtener información sobre cómo habilitar el registro, consulta Usar Cloud Logging con colas.

Si no ves el resultado esperado, puedes probar lo siguiente:

• Espera al menos un minuto a que se inicialice la cola.

• Asegúrate de que no existe una cola con el mismo ID. Para ver las colas de tu proyecto, usa el comando gcloud tasks queues list:

  gcloud tasks queues list \
      --location=LOCATION

  Para buscar en varias ubicaciones, debes hacer varias solicitudes.

• Comprueba si has alcanzado tu cuota de la cola:

  1. En la Google Cloud consola, ve a la página Detalles de la API o el servicio de la API Cloud Tasks .

     Ir a Detalles de la API o del servicio

  2. Haz clic en la pestaña Cuotas y límites del sistema.

  3. Para aumentar una cuota, en la fila correspondiente, haz clic en el icono de elipsis > Editar cuota.

     Para obtener más información, consulta Solicitar un ajuste de cuota.

• Vuelve a ejecutar los comandos para crear la cola y asegúrate de que cada paso se completa correctamente.

Siguientes pasos

• Configurar colas de Cloud Tasks
• Referencia de la API REST
• Referencia de la API RPC
• Comandos de Cloud Tasks gcloud