Jobs

Atomic Unit of Work

A "job" is an atomic unit of work that is put into a tube.

Generally, a job consists of a chunk of JSON text that is put into the tube

When adding a job to a tube, you need to set a TTL (Time To Live) on a job, which indicates how long a consumer has to process a job.

When a job is reserved from a tube it is temporarily removed from the tube, and the process reserving the job has a certain amount of time (TTL) to process that job, otherwise the job is automatically put back into the tube.

Jobs can have the following actions performed on them

  • Delete (remove from tube)

  • Touch (reset TTL, allows the job to be reserved for longer than TTL)

  • Bury (put job in "buried" state, aka dead letter queue)

  • Release (release job back into tube)

Last updated