Agrega una tarea de destino HTTP a una cola de Cloud Tasks

Agrega una tarea de destino HTTP a una cola de Cloud Tasks

En esta guía de inicio rápido, se muestra cómo agregar una tarea de destino HTTP a una cola de Cloud Tasks con la API de Cloud Tasks.

Antes de comenzar

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
2. Instala Google Cloud CLI.

3. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

6. Habilita la API de Cloud Tasks:

   gcloud services enable tasks.googleapis.com

7. Crea credenciales de autenticación locales para tu Cuenta de Google:

   gcloud auth application-default login

8. Instala Google Cloud CLI.

9. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

   gcloud init

10. Create or select a Google Cloud project.

    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

11. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

12. Habilita la API de Cloud Tasks:

    gcloud services enable tasks.googleapis.com

13. Crea credenciales de autenticación locales para tu Cuenta de Google:

    gcloud auth application-default login

Crea una cola de Cloud Tasks

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

Precaución: El uso de los métodos de administración de colas gcloud de Cloud Tasks implica cierto riesgo si se usa junto con métodos basados en la carga de queue.yaml/queue.xml. Para obtener más información, consulta Usa la administración de colas o queue.yaml.

1. En la terminal, crea una cola que registre todas las operaciones.

   gcloud tasks queues create QUEUE_NAME \
       --log-sampling-ratio=1.0 \
       --location=REGION
   

   Reemplaza lo siguiente:

   • QUEUE_NAME: Es un nombre para la cola de Cloud Tasks.
   • REGION: Es la región en la que implementaste el servicio o la app.

2. Espera a que se inicialice la cola y, luego, verifica que se haya creado correctamente.

   gcloud tasks queues describe QUEUE_NAME \
       --location=REGION
   

   El resultado debería ser similar al siguiente ejemplo:

    name: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_NAME
    rateLimits:
      maxBurstSize: 100
      maxConcurrentDispatches: 1000
      maxDispatchesPerSecond: 500.0
    retryConfig:
      maxAttempts: 100
      maxBackoff: 3600s
      maxDoublings: 16
      minBackoff: 0.100s
    state: RUNNING
   

Agrega una tarea a la cola de Cloud Tasks

Usa el comando gcloud tasks create-http-task para crear una tarea que se dirija a un extremo HTTP y agrégala a tu cola.

1. Crea una tarea, agrégala a la cola que creaste y entrégala a un extremo HTTP.

   gcloud tasks create-http-task \
       --queue=QUEUE_NAME \
       --url=URL_PATH \
       --method=GET \
       --location=REGION \
       --project=PROJECT_ID
   

   Reemplaza URL_PATH por la ruta de URL completa a la que se enviará la solicitud. Por ejemplo: https://www.google.com.

   La ruta de acceso debe comenzar con http:// o https://.

2. Verifica que la tarea se haya ejecutado correctamente mediante la lectura de los registros.

   gcloud logging read --limit=3
   

   Los registros deberían ser similares a los siguientes:

   jsonPayload:
   '@type': type.googleapis.com/google.cloud.tasks.logging.v1.TaskActivityLog
   task: projects/PROJECT_ID/locations/REGION/queues/QUEUE_NAME/tasks/TASK_ID
   taskCreationLog:
      scheduleTime: '2024-07-04T19:00:27.801837Z'
      status: OK
      targetAddress: GET https://www.google.com/
      targetType: HTTP
   

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en esta página, borra el proyecto de Cloud que tiene los recursos.

Precaución: Borrar un proyecto tiene estas consecuencias:

• Se borra todo en el proyecto. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varias infraestructuras, instructivos y guías de inicio rápido la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

Borra un proyecto de Google Cloud:

gcloud projects delete PROJECT_ID

Como alternativa, puedes borrar la cola de Cloud Tasks:

gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

¿Qué sigue?

• Administra colas y tareas
• Crea colas de Cloud Tasks
• Referencia de la API de RPC
• Referencia de la API de REST