Ajouter une tâche HTTP cible à une file d'attente Cloud Tasks

Ajouter une tâche HTTP cible à une file d'attente Cloud Tasks

Ce guide de démarrage rapide explique comment ajouter une tâche cible HTTP à une file d'attente Cloud Tasks à l'aide de l'API Cloud Tasks.

Avant de commencer

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
2. Installez Google Cloud CLI.

3. Pour initialiser gcloudCLI, exécutez la commande suivante :

   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. Vérifiez que la facturation est activée pour votre projet Google Cloud.

6. Activer l'API Cloud Tasks :

   gcloud services enable tasks.googleapis.com

7. Créez des identifiants d'authentification locaux pour votre compte Google :

   gcloud auth application-default login

8. Installez Google Cloud CLI.

9. Pour initialiser gcloudCLI, exécutez la commande suivante :

   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. Vérifiez que la facturation est activée pour votre projet Google Cloud.

12. Activer l'API Cloud Tasks :

    gcloud services enable tasks.googleapis.com

13. Créez des identifiants d'authentification locaux pour votre compte Google :

    gcloud auth application-default login

Créer une file d'attente Cloud Tasks

Exécutez la commande gcloud tasks queues create pour créer votre file d'attente.

Attention :L'utilisation des méthodes de gestion des files d'attente gcloud de Cloud Tasks présente des risques si elle est utilisée avec des méthodes basées sur l'importation de queue.yaml/queue.xml. Pour en savoir plus, consultez la page Utiliser la gestion des files d'attente ou queue.yaml.

1. Dans votre terminal, créez une file d'attente qui consigne toutes les opérations.

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

   Remplacez les éléments suivants :

   • QUEUE_NAME: nom de votre file d'attente Cloud Tasks
   • REGION: région dans laquelle vous avez déployé votre service ou votre application

2. Attendez que la file d'attente s'initialise, puis vérifiez qu'elle a bien été créée.

   gcloud tasks queues describe QUEUE_NAME \
       --location=REGION
   

   La sortie devrait ressembler à ce qui suit :

    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
   

Ajouter une tâche à la file d'attente Cloud Tasks

Exécutez la commande gcloud tasks create-http-task pour créer une tâche qui cible un point de terminaison HTTP et l'ajouter à votre file d'attente.

1. Créez une tâche, ajoutez-la à la file d'attente que vous avez créée et transmettez cette tâche à un point de terminaison HTTP.

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

   Remplacez URL_PATH par le chemin d'URL complet auquel la requête sera envoyée. Par exemple : https://www.google.com

   Le chemin d'accès doit commencer par http:// ou https://.

2. Vérifiez que la tâche a bien été exécutée en lisant les journaux.

   gcloud logging read --limit=3
   

   Les journaux doivent ressembler à ce qui suit:

   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
   

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud, supprimez le projet Google Cloud contenant les ressources.

Attention : La suppression d'un projet aura les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches de ce document, lorsque vous le supprimez, vous supprimez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

Supprimez un projet Google Cloud :

gcloud projects delete PROJECT_ID

Vous pouvez également supprimer la file d'attente Cloud Tasks:

gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

Étapes suivantes

• Gérer les files d'attente et les tâches
• Créer des files d'attente Cloud Tasks
• Documentation de référence de l'API RPC
• Documentation de référence de l'API REST