Gearman

Queuegearman

Lightweight job server that farms work out to workers from an in-memory queue.

Provider
default
Kind
Queue
Category
Messaging
Properties · 5 set by this component
propertytypevaluesrequiredkind defaultthis component
backoffenumnone | fixed | exponential | exponential-jitterno—inherited
deadLetterQueueboolean—nofalse▸ false
deliveryenumat-most-once | at-least-once | exactly-onceyes—▸ at-most-once
instancesinteger—no—inherited
managedboolean—nofalseinherited
maxAttemptsinteger—no—inherited
orderingenumnone | per-key | globalnonone▸ none
persistenceboolean—notrue▸ false
replayboolean—nofalse▸ false
retentionDaysinteger—no—inherited
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: "gearman", component: "gearman" }
Other Queue products · 23
Source
# yaml-language-server: $schema=../../schema/component.schema.json
# Gearman job server: in-memory queue with no persistence unless a persistent backend is configured,
# so a server restart drops queued jobs.
schemaVersion: "1"
type: "component"
id: "gearman"
kind: "queue"
provider: "default"
docs: "https://gearman.org/documentation/"
defaults:
  delivery: "at-most-once"
  ordering: "none"
  deadLetterQueue: false
  replay: false
  persistence: false

The same page as markdown, for an agent: /catalogue/components/gearman.md