Créer des files d'attente Cloud Tasks

Cette page explique comment créer des files d'attente Cloud Tasks à l'aide de la commande gcloud de la gcloud CLI.

Avant de commencer

Les noms de file d'attente se composent de trois parties: un ID de projet, un emplacement et un ID de file d'attente. Pour tous les types de cibles, vous devez disposer d'un projet Google Cloud. Il fournit l'ID de projet.

Si vous utilisez des tâches cibles App Engine, vous devez également disposer d'une application App Engine. L'application se trouve dans une région spécifique, qui sert de partie d'emplacement du nom de la file d'attente. Notez-la lorsque vous ajoutez l'application. C'est à cet emplacement que votre file d'attente et vos gestionnaires s'exécutent.

En revanche, l'utilisation de tâches de cible HTTP ne nécessite pas d'application App Engine. Vous sélectionnez un emplacement Google Cloud lorsque vous créez votre file d'attente.

Créer une file d'attente Cloud Tasks

Utilisez le SDK Google Cloud pour créer une file d'attente :

    gcloud tasks queues create QUEUE_ID --location=LOCATION

Remplacez les éléments suivants :

  • LOCATION: emplacement où la file d'attente s'exécute, 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 de l'organisation doit autoriser la création de file d'attente dans us-central1 et us-central2 (même si vous n'avez besoin que d'une file d'attente dans l'une de ces régions).

  • QUEUE_ID: identifiant que vous attribuez à votre file d'attente, par exemple my-queue.

Quelques minutes peuvent être nécessaires pour qu'une file d'attente nouvellement créée soit disponible. Utilisez ensuite describe pour vérifier que la file d'attente a bien été créée:

   gcloud tasks queues describe QUEUE_ID --location=LOCATION

Remplacez les éléments suivants :

  • QUEUE_ID: ID de la file d'attente (son nom court)
  • LOCATION: emplacement de la file d'attente

Un résultat semblable aux lignes suivantes doit s'afficher :

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 le résultat précédent ne s'affiche pas, vous pouvez essayer ce qui suit:

  • Attendez au moins une minute pour que la file d'attente s'initialise.

  • Assurez-vous qu'une file d'attente avec le même ID n'existe pas déjà. Vous pouvez afficher les files d'attente de votre projet en appelant:

    gcloud tasks queues list --location=LOCATION

    Pour rechercher plusieurs lieux, vous devez envoyer plusieurs requêtes.

  • Vérifiez si vous avez atteint votre limite de file d'attente :

    Accédez à la page de l'API Cloud Tasks

    et sélectionnez Quotas.

    Pour augmenter vos limites de ressources, sélectionnez Modifier les quotas sur la page "Quotas" de la consoleGoogle Cloud .

  • Vérifiez chaque partie de la commande et exécutez-la à nouveau.

Étape suivante