Creating Pull Queues

This page describes how to create a pull queue. You must create the queue before you can add tasks to it. The page also describes how to pause or delete a queue.

Defining queues with queue.xml

You create pull queues using the queue.xml file for your application. The process is the same as creating named push queues, with a specialized directive, <mode>pull</mode>, added to the file.

<?xml version="1.0" encoding="UTF-8"?>
<queue-entries>
  <queue>
    <name>my-queue-name</name>
    <mode>pull</mode>
  </queue>
</queue-entries>
Use the App Engine SDK to upload the file.

On Mac/Linux:

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

or on Windows:

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

Disabling queues

You can disable, or pause, a queue by removing its definition from your queue.xml file and then uploading the updated file.

If you disable a queue by omitting it from the queue.xml and uploading it, the queue is set to "disabled" and its rate is set to 0. Any tasks that are in the queue or new tasks that are added to the queue will not be processed. You can re-enable the disabled queue by uploading a new queue.xml file with the queue defined.

You can also pause a queue from within the Task Queues page in the GCP Console

Deleting queues

To delete a queue:

  1. Remove the queue definition from your queue.xml file.

  2. Upload the change to your queue.xml file.

    On Mac/Linux:

    [PATH_TO_APP_ENGINE_SDK]\bin\appcfg.sh update_queues myapp/war
    

    or on Windows:

    [PATH_TO_APP_ENGINE_SDK]\bin\appcfg.cmd update_queues myapp/war
    

  3. Delete the queue in the GCP Console, select the queue and click Delete queue:

    Go to the Task queues page

If you delete a queue, you must wait 7 days before recreating with the same name.

What's next

Send feedback about...

App Engine standard environment for Java