Google Cloud Tasks

gcpQueuegoogle-cloud-tasks

Managed push queue that dispatches HTTP tasks with rate limiting and exponential retry.

Provider
gcp
Kind
Queue
Category
Messaging
Properties · 8 set by this component
propertytypevaluesrequiredkind defaultthis component
backoffenumnone | fixed | exponential | exponential-jitterno—▸ exponential
deadLetterQueueboolean—nofalse▸ false
deliveryenumat-most-once | at-least-once | exactly-onceyes—▸ at-least-once
instancesinteger—no—inherited
managedboolean—nofalse▸ true
maxAttemptsinteger—no—inherited
maxDispatchesPerSecond · component propertyinteger—no500inherited
orderingenumnone | per-key | globalnonone▸ none
persistenceboolean—notrue▸ true
replayboolean—nofalse▸ false
retentionDaysinteger—no—▸ 31
roleenumwork | dlq | retry | offline-mailbox | frontiernoworkinherited
Rules that apply · 3

Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.

queue-missing-dlq

A queue that receives asynchronous traffic and has no dead-letter queue either drops poison messages or retries them forever. Neither outcome leaves anything for a human to investigate.

  • — all of these hold:
  • — the node's `deadLetterQueue` is false
  • — the node has at least one asynchronous incoming edge
retry-queue-without-dlq

A retry queue is where poison messages end up. With no dead-letter queue they are retried forever or dropped in silence, and nobody ever looks at the failed payment.

  • — all of these hold:
  • — the node's `role` is "retry"
  • — the node's `deadLetterQueue` is false
retry-without-backoff

Retrying a transient failure at full speed turns one slow dependency into a retry storm. A retry queue backs off, preferably exponentially and with jitter.

  • — all of these hold:
  • — the node's `role` is "retry"
  • — any of these hold:
  • — the node's `backoff` has no value
  • — the node's `backoff` is "none"
Use it in a design
nodes:
  - { id: "cloud-tasks", component: "google-cloud-tasks" }
Other Queue products · 23
Source
# yaml-language-server: $schema=../../schema/component.schema.json
# Google Cloud Tasks: managed push queue that dispatches HTTP tasks with built-in exponential backoff
# and retries until the 31-day maximum task age unless a queue-level limit is set.
schemaVersion: "1"
type: "component"
id: "google-cloud-tasks"
kind: "queue"
provider: "gcp"
docs: "https://cloud.google.com/tasks/docs/dual-overview"
defaults:
  managed: true
  delivery: "at-least-once"
  ordering: "none"
  deadLetterQueue: false
  replay: false
  retentionDays: 31
  persistence: true
  backoff: "exponential"
properties:
  maxDispatchesPerSecond:
    type: "integer"
    default: 500

The same page as markdown, for an agent: /catalogue/components/google-cloud-tasks.md