app:monitor:job:retry¶

Dispatch a failed background job's stored message again, under a new job ID. The command does what the Retry action of the admin Job Monitor does through POST /api/monitor/jobs/{jobId}/retry, with the same checks.

Quick start¶

The Make examples below target the checkout's development preview. For an installed instance, use the dc function from Getting started and replace make exec cmd="php bin/console …" with dc exec app php bin/console ….

make exec cmd="php bin/console app:monitor:job:retry <jobId>"

Print the result as JSON, for a script:

make exec cmd="php bin/console app:monitor:job:retry <jobId> --json"

Arguments¶

Options¶

Details¶

The message goes to the transport the job was received from. A job that a console command ran inline has no transport, so its message goes through its normal routing. The new job appears in app:monitor:jobs once a worker starts it; the command prints its ID.

A job is retried at most once. The original job is marked as retried, and its audit log records the new job ID, the time and the actor cli. A retry from the admin panel records the admin's email address instead.

The command refuses a job that has not failed, one that was already retried, and one whose message was not stored or cannot be read. When two retries of the same job run at once, only one dispatches the message. If the dispatch itself fails, the job stays retriable.

With --json the command prints only {"newJobId": "..."}, the API's data object with the ID of the dispatched job.

Exit codes¶