| name | cloud-tasks-queue-setup |
| description | Configure cloud tasks queue setup operations. Auto-activating skill for GCP Skills.
Triggers on: cloud tasks queue setup, cloud tasks queue setup
Part of the GCP Skills skill category. Use when working with cloud tasks queue setup functionality. Trigger with phrases like "cloud tasks queue setup", "cloud setup", "cloud".
|
| allowed-tools | Read, Write, Edit, Bash(gcloud:*) |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["gcp","cloud"] |
| compatibility | Designed for Claude Code |
Cloud Tasks Queue Setup
Overview
Create and configure Google Cloud Tasks queues for reliable asynchronous task execution. Covers queue creation with rate limiting and retry policies, HTTP and App Engine task targets, task dispatching with scheduling delays, and queue management operations (pause, resume, purge).
Prerequisites
- Google Cloud project with Cloud Tasks API enabled (
gcloud services enable cloudtasks.googleapis.com)
gcloud CLI authenticated with roles/cloudtasks.admin or roles/cloudtasks.enqueuer IAM role- Target HTTP endpoint or App Engine service to receive dispatched tasks
- Service account with appropriate permissions for task execution
Instructions
- Create a Cloud Tasks queue with rate limiting:
gcloud tasks queues create <queue-name> --location=<region> --max-dispatches-per-second=10 --max-concurrent-dispatches=5
- Configure retry policy for failed tasks:
gcloud tasks queues update <queue-name> --max-attempts=5 --min-backoff=1s --max-backoff=300s --max-doublings=4
- Create an HTTP task targeting your endpoint:
gcloud tasks create-http-task --queue=<queue-name> --url=https://your-service.run.app/process --method=POST --body-content='<json-payload>'
- Schedule a delayed task by adding
--schedule-time with an ISO 8601 timestamp up to 30 days in the future
- Verify queue status and task counts:
gcloud tasks queues describe <queue-name> to check dispatch rate, retry config, and queue state
- Manage queue operations: pause (
gcloud tasks queues pause), resume (gcloud tasks queues resume), or purge all tasks (gcloud tasks queues purge)
Examples
Setting up an email processing queue: Create a queue with 5 dispatches per second rate limit and 3 max concurrent tasks to avoid overwhelming the email service. Configure retry with exponential backoff (1s min, 60s max, 3 doublings) and 10 max attempts for transient failures.
Scheduling delayed webhook callbacks: Create HTTP tasks with a 15-minute schedule delay to implement webhook retries. Each task POSTs to the callback URL with the original event payload and includes an OIDC token for authentication.
Output
- Cloud Tasks queue created with rate limiting and retry configuration
- Task creation commands for HTTP and App Engine targets
- Queue management commands for operational control
