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.

Définir des files d'attente avec un fichier de configuration de file d'attente

Pour créer des files d'attente de retrait, utilisez le fichier de configuration de file d'attente, queue.xml ou 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</mode>, ajoutée au fichier.

appcfg/xml

<?xml version="1.0" encoding="UTF-8"?>
<queue-entries>
  <queue>
    <name>my-queue-name</name>
    <mode>pull</mode>
  </queue>
</queue-entries>

gcloud/yaml

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

Pour importer le fichier :

appcfg/xml

Mac/Linux :

[PATH_TO_APP_ENGINE_SDK]\bin\appcfg.sh update [YOUR_APP_DIR]

Windows :

[PATH_TO_APP_ENGINE_SDK]\bin\appcfg.cmd update [YOUR_APP_DIR]

gcloud/yaml

gcloud app deploy queue.yaml

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 Files d'attente de tâches de Cloud Console.

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é.

appcfg/xml

[PATH_TO_APP_ENGINE_SDK]\bin\appcfg.sh update_queues [YOUR_APP_DIR]

Ou sous Windows :

[PATH_TO_APP_ENGINE_SDK]\bin\appcfg.cmd update_queues [YOUR_APP_DIR]

gcloud/yaml

gcloud app deploy queue.yaml

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

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

    Accéder à la page "Files d'attente de tâches"

  2. Cliquez sur Supprimer la file d'attente.

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

Étape suivante