graham/towerops
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
towerops/vendor/oban_pro/usage-rules/chains.md
Graham McIntire 6c05d45dd6 deps: upgrade oban_pro to 1.7.0 
Bumps vendored Oban Pro from 1.6.13 to 1.7.0, which transitively bumps
oban core to 2.22.1 (requires migrations v14) and db_connection to 2.10.0.

- mix.exs constraint: ~> 1.6 → ~> 1.7
- vendor/oban_pro/ replaced with v1.7.0 hex package
- migration 20260430142200: Oban core v12 → v14 (must run first)
- migration 20260430142241: Oban Pro 1.7.0 schema additions

Also corrects a pre-existing constraint name in AgentAssignment that was
left stale by the equipment→devices rename migration (20260117190134).
The unique index is named agent_assignments_device_id_index, but the
schema's unique_constraint/3 still pointed at the old equipment_id name,
causing the test suite to surface Ecto.ConstraintError instead of a
changeset error. Required to get the suite green for this upgrade.
2026-04-30 10:26:18 -05:00

989 B
Raw Blame History

Chains

Chains ensure jobs run sequentially for the same entity. Use when order matters (e.g., webhook processing, account balance updates).

defmodule MyApp.WebhookWorker do
  use Oban.Pro.Worker,
    queue: :webhooks,
    chain: [by: [args: :account_id]]

  @impl Oban.Pro.Worker
  def process(%Oban.Job{args: args}) do
    MyApp.Account.handle_webhook(args["account_id"], args["event"])
  end
end

Partitioning

chain: [by: :worker]                        # All jobs of this worker chain together
chain: [by: [args: :account_id]]            # Chain by account_id across workers
chain: [by: [:worker, args: :account_id]]   # Chain by worker AND account_id
chain: [by: [args: [:account_id, :region]]] # Chain by multiple args

Handling failures

chain: [by: [args: :id], on_discarded: :hold, on_cancelled: :hold]
  • :ignore (default) — continue processing downstream jobs
  • :hold — stop the chain until the failed job is resolved