Créer des files d'attente Cloud Tasks

Cette page explique comment créer des files d'attente Cloud Tasks. Lorsque des tâches sont ajoutées à une file d'attente, celle-ci les envoie et s'assure qu'elles sont traitées de manière fiable par un service, également appelé nœud de calcul.

Veuillez noter les points suivants :

  • Les noms de file d'attente comportent trois parties : un ID de projet, un emplacement et un ID de file d'attente. Vous devez disposer d'un Google Cloud projet qui fournit l'ID du projet.

  • Si vous utilisez des tâches cibles App Engine, vous devez également disposer d'une application App Engine située dans une région spécifique et dans laquelle votre file d'attente et vos gestionnaires s'exécutent. Notez la région lorsque vous ajoutez l'application.

  • L'utilisation de tâches cibles HTTP ne nécessite pas d'application App Engine. Vous sélectionnez un Google Cloud emplacement lorsque vous créez votre file d'attente.

Créer une file d'attente

Vous pouvez créer une file d'attente de différentes manières :

  • Dans la Google Cloud console
  • À l'aide de Google Cloud CLI dans votre terminal ou Cloud Shell
  • En envoyant une requête directe à l'API Cloud Tasks

Console

  1. Dans la Google Cloud console, accédez à la page Cloud Tasks > Files d'attente.

    Accéder aux files d'attente

  2. Cliquez sur Créer une file d'attente.

  3. Saisissez un nom de file d'attente, par exemple my-queue.

  4. Dans la liste Région, sélectionnez un emplacement compatible dans lequel la file d'attente s'exécutera, par exemple asia-south1.

    Si votre organisation limite l'emplacement des ressources et que vous souhaitez créer votre file d'attente dans us-central1 ou us-central2, la règle d'administration doit autoriser la création de files d'attente dans les deux régions (us-central1 et us-central2), même si vous n'avez besoin d'une file d'attente que dans l'une de ces régions.

  5. Vous pouvez également configurer votre file d'attente .

  6. Cliquez sur Créer.

gcloud

Utilisez la gcloud tasks queues create commande pour créer votre file d'attente :

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Remplacez les éléments suivants :

D'autres options de la commande gcloud CLI vous permettent de configurer les limites de débit, les options de nouvelle tentative, les types de files d'attente, etc.

API REST

Pour créer une file d'attente, utilisez la projects.locations.queues.create méthode.

Avant d'utiliser les données de la requête, effectuez les remplacements suivants :

D'autres propriétés configurables pour la Queue ressource incluent les limites de débit, les options de nouvelle tentative, les types de files d'attente, etc.

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Si la requête aboutit, le corps de la réponse contient une nouvelle instance 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"
}

Quelques minutes peuvent être nécessaires pour qu'une file d'attente nouvellement créée soit disponible.

Décrire votre file d'attente

Vous pouvez vérifier que votre file d'attente a été créée de différentes manières :

  • Dans la Google Cloud console
  • À l'aide de gcloud CLI dans votre terminal ou Cloud Shell
  • En envoyant une requête directe à l'API Cloud Tasks

Console

  1. Dans la Google Cloud console, accédez à la page Cloud Tasks > Files d'attente.

    Accéder aux files d'attente

    Une coche verte doit indiquer que votre file d'attente est en cours d'exécution.

  2. Pour plus d'informations, cliquez sur le nom de la file d'attente, puis sur l'onglet Configuration.

gcloud