En esta página, se describe cómo crear
colas de Cloud Tasks
con el comando gcloud
de gcloud CLI.
Antes de comenzar
Los nombres de las colas constan de tres partes: un ID del proyecto, una ubicación y un ID de cola. Para todos los tipos de destino, debes tener un proyecto de Google Cloud que proporcione el ID del proyecto.
Si usas tareas de destino de App Engine, también debes tener una app de App Engine. La app se encuentra en una región específica, y esta región sirve como parte de la ubicación del nombre de la cola, así que anótala cuando agregues la app. Esta ubicación es donde se ejecutan la cola y los controladores.
Por otro lado, el uso de tareas de destino HTTP no requiere una aplicación de App Engine. Debes seleccionar una ubicación de Google Cloud cuando creas la cola.
Crea una cola de Cloud Tasks
Usa el SDK de Google Cloud para crear tu cola:
gcloud tasks queues create QUEUE_ID --location=LOCATION
Reemplaza lo siguiente:
LOCATION
: Es la ubicación en la que se ejecuta la cola, por ejemplo,europe-west4
.- Si tu organización restringe la ubicación de recursos y deseas crear la 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).
- Si tu organización restringe la ubicación de recursos y deseas crear la cola en
QUEUE_ID
: Es el identificador que asignas a tu cola, por ejemplo,my-queue
.
Pueden pasar varios minutos antes de que una cola recién creada esté disponible. Luego, usa
describe
para verificar que la cola se haya creado de forma correcta:
gcloud tasks queues describe QUEUE_ID --location=LOCATION
Reemplaza lo siguiente:
QUEUE_ID
: El ID de la cola (su nombre corto)LOCATION
: Es la ubicación de la cola.
El resultado debería ser algo como lo 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
Si no ves el resultado anterior, 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. Para ver las colas de tu proyecto, llama al siguiente comando:
gcloud tasks queues list --location=LOCATION
Para buscar varias ubicaciones, debes realizar varias solicitudes.
Verifica si alcanzaste tu límite de colas:
Ir a la página de la API de Cloud Tasks
y selecciona Cuotas.
Para aumentar tus límites de recursos, selecciona Editar cuotas en la página Cuotas de la consola de Google Cloud.
Verifica cada parte del comando y vuelve a ejecutarlo.
¿Qué sigue?
- Aprende a configurar colas de Cloud Tasks.
- Obtén más información acerca de la administración de cuentas en la referencia de API de RPC.
- Obtén más información acerca de la administración de cuentas en la referencia de API de REST.
- Consulta la lista completa de comandos de
gcloud
de Cloud Tasks.