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
Le nom des files d'attente se compose 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, qui fournit l'ID du 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 d'emplacement pour le nom de la file d'attente. Prenez-en note lorsque vous ajoutez l'application. C'est là que votre file d'attente et vos gestionnaires s'exécutent.
En revanche, l'utilisation de tâches HTTP Target 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 d'exécution de la file d'attente, par exempleeurope-west4
.- Si votre organisation restreint l'emplacement des ressources et que vous souhaitez créer votre file d'attente dans
us-central1
ouus-central2
, la règle d'administration doit autoriser la création de files d'attente dansus-central1
etus-central2
(même si vous n'avez besoin d'une file d'attente que dans l'une de ces régions).
- Si votre organisation restreint l'emplacement des ressources et que vous souhaitez créer votre file d'attente dans
QUEUE_ID
: identifiant que vous attribuez à votre file d'attente, par exemplemy-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 (nom abrégé)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 la procédure suivante:
- 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 la méthode suivante:
gcloud tasks queues list --location=LOCATION
Pour rechercher plusieurs établissements, vous devez effectuer plusieurs demandes.
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 console Google Cloud.
Vérifiez chaque partie de la commande et exécutez-la à nouveau.
Étapes suivantes
- Découvrez comment configurer des files d'attente Cloud Tasks.
- Pour en savoir plus sur la gestion des files d'attente, consultez la documentation de référence de l'API RPC.
- Apprenez-en davantage sur la gestion des files d'attente dans la documentation de référence de l'API REST.
- Consultez la liste complète des commandes
gcloud
Cloud Tasks.