Blog Detail


Google Cloud Tasks to be used as the Queue Driver in Laravel cover image

arrow_back Google Cloud Tasks to be used as the Queue Driver in Laravel

Laravel Google Cloud Tasks Queue package allows Google Cloud Tasks to be used as the queue driver. This package requires Laravel 6 or higher and supports MySQL 8 and PostgreSQL 14. Might support older database versions too, but the package hasn’t been tested for it.


For the installation purpose, Please require the package using Composer.

composer require stackkit/laravel-google-cloud-tasks-queue

Add a new queue connection to config/queue.php.

'cloudtasks' => [
    'driver' => 'cloudtasks',
    'project' => env('STACKKIT_CLOUD_TASKS_PROJECT', ''),
    'location' => env('STACKKIT_CLOUD_TASKS_LOCATION', ''),
    'handler' => env('STACKKIT_CLOUD_TASKS_HANDLER', ''),
    'queue' => env('STACKKIT_CLOUD_TASKS_QUEUE', 'default'),
    'service_account_email' => env('STACKKIT_CLOUD_TASKS_SERVICE_EMAIL', ''),
    // Optional: The deadline in seconds for requests sent to the worker. If the worker
    // does not respond by this deadline then the request is canceled and the attempt
    // is marked as a DEADLINE_EXCEEDED failure.
    'dispatch_deadline' => null,
    'backoff' => 0,

Update the QUEUE_CONNECTION environment variable


How it works & Differences

Using Cloud Tasks as a Laravel queue driver is fundamentally different than other Laravel queue drivers, like Redis.

Typically a Laravel queue has a worker that listens to incoming jobs using the queue:work / queue:listen command. With Cloud Tasks, this is not the case. Instead, Cloud Tasks will schedule the job for you and make an HTTP request to your application with the job payload. There is no need to run a queue:work/listen command.

Dashboard (beta)

The package comes with a beautiful dashboard that can be used to monitor all queued jobs.

The dashboard works by storing all outgoing tasks in a database table. When Cloud Tasks calls the application and this package handles the task, we will automatically update the tasks’ status, attempts, and possible errors.

There is probably a (small) performance penalty because each task dispatch and handling does extra database reads and writes. Also, the dashboard has not been tested with high throughput queues.

To make use of it, enable it through the .env file:


Then publish its assets and migrations:

php artisan vendor:publish --tag=cloud-tasks
php artisan migrate

The dashboard is accessible at the URI: /cloud-tasks


Set the GOOGLE_APPLICATION_CREDENTIALS environment variable with a path to the credentials file.

More info:

If you’re not using your master service account (which has all abilities), you must add the following roles to make it works:

  1. App Engine Viewer
  2. Cloud Tasks Enqueuer
  3. Cloud Tasks Viewer
  4. Cloud Tasks Task Deleter
  5. Service Account User


The job handler requires each request to have an OpenID token. In the installation step, we set the service account email, and with that service account, Cloud Tasks will generate an OpenID token and send it along with the job payload to the handler.

This package verifies that the token is digitally signed by Google. Only Google Tasks will be able to call your handler.

For more details about this package, Please visit Github.

Published at : 17-11-2022

Author : Rizwan Aslam
Rizwan Aslam

I am a highly results-driven professional with 12+ years of collective experience in the grounds of web application development especially in laravel, native android application development in java, and desktop application development in the dot net framework. Now managing a team of expert developers at Codebrisk.

Launch your project

Launch project