Créer des files d'attente de retrait

Cette page explique comment créer une file d'attente de retrait. Vous devez créer la file d'attente avant de pouvoir y ajouter des tâches. Vous apprendrez également à suspendre et à supprimer une file d'attente.

Cette API est compatible avec les environnements d'exécution de première génération et peut être utilisée lors de la mise à niveau vers des environnements d'exécution de deuxième génération correspondants. Si vous effectuez une mise à jour vers l'environnement d'exécution Python 3 d'App Engine, consultez le guide de migration pour en savoir plus sur les options de migration des anciens services groupés.

Définir des files d'attente avec queue.yaml

Pour créer des files d'attente de retrait, utilisez le fichier queue.yaml de votre application. Le processus est le même que pour la création de files d'attente d'envoi nommées, avec une directive spécialisée mode: pull ajoutée au fichier.

queue:
- name: my-queue-name
  mode: pull

Vous utilisez la commande gcloud de gcloud CLI pour importer le fichier.

gcloud app deploy queue.yaml

Remarque : Si vous utilisez un compte de service pour gérer l'authentification lors du déploiement de votre fichier de configuration de file d'attente, il doit disposer de l'autorisation serviceusage.services.list. Vous pouvez ajouter cette autorisation à l'aide du rôle serviceusage.serviceUsageViewer ou en créant un rôle personnalisé associé à cette autorisation.

Attention : La création d'une file d'attente pour le service de file d'attente de tâches peut également être gérée à l'aide des méthodes de gestion des files d'attente de l'API Cloud Tasks. En revanche, l'association de la méthode d'importation queue.yaml et des méthodes de gestion des files d'attente peut produire des résultats inattendus et n'est pas recommandée. Pour en savoir plus, consultez la page de présentation de la gestion des files d'attente et de queue.yaml. Notez également que l'importation d'un fichier queue.yaml via une version de gcloud CLI inférieure à la version 332.0.0 utilise une interface obsolète pour le service. À compter du 2022-09-20, les tentatives d'utilisation de la méthode d'importation peuvent échouer en renvoyant des erreurs de serveur. Pour résoudre ce problème, assurez-vous que l'API Cloud Tasks est activée dans votre projet et que gcloud CLI a au moins été mis à jour vers la version 332.0.0.

Désactiver des files d'attente

Vous pouvez désactiver ou suspendre une file d'attente en supprimant sa définition du fichier de configuration de la file d'attente, puis en important le fichier modifié.

Une fois le fichier mis à jour importé, la file d'attente est définie sur "désactivée" et sa valeur sur 0. Aucune des tâches figurant dans la file d'attente ou y étant ajoutées ne sera traitée. Vous pouvez réactiver la file d'attente désactivée en important un nouveau fichier de file d'attente dans lequel la file d'attente est définie.

Vous pouvez également suspendre une file d'attente à partir de la page Cloud Tasks dans la console Google Cloud.

Supprimer des files d'attente

Pour supprimer une file d'attente, vous devez d'abord la désactiver :

1. Supprimez la définition de la file d'attente du fichier de configuration.

2. Importez le fichier modifié.

   gcloud app deploy queue.yaml
   

Une fois la file d'attente désactivée, utilisez la console Google Cloud pour la supprimer.

1. Dans la console Google Cloud, sélectionnez la file d'attente.

   Accéder à Cloud Tasks

2. Cliquez sur Supprimer la file d'attente.

Si vous supprimez une file d'attente de la console Google Cloud, vous devez attendre sept jours avant de pouvoir recréer une file d'attente portant le même nom.

Important : Le serveur de développement local (dev_appserver) n'est pas compatible avec les files d'attente de retrait. Pour tester vos files d'attente de retrait et vous assurer que les détails de votre configuration sont corrects, vous devez transférer votre fichier de configuration vers un environnement de préproduction App Engine.

Étape suivante

Découvrez comment créer des tâches.