Skip to content

Document how to update dynamic recurring tasks - #777

Merged
rosa merged 1 commit into
rails:mainfrom
wintan1418:document-dynamic-task-updates
Jul 30, 2026
Merged

Document how to update dynamic recurring tasks#777
rosa merged 1 commit into
rails:mainfrom
wintan1418:document-dynamic-task-updates

Conversation

@wintan1418

Copy link
Copy Markdown
Contributor

Follow-up to #774 and #739, related to #738.

Updating a dynamic recurring task in place (e.g. task.update!(schedule: ...)) isn't picked up by a running scheduler — by design, the way to update a task is to unschedule it and schedule it again, as @rosa explained in #739 (comment).

Since this wasn't stated in the README's dynamic tasks section and has now come up a few times (#738 plus two PRs attempting the same fix), this adds a short paragraph spelling it out.

The scheduler only detects dynamic tasks being created and deleted, so
updating a SolidQueue::RecurringTask record in place isn't picked up
until a restart. This is by design: the documented way to update a task
is to unschedule it and schedule it again.

This wasn't stated in the README and has caused some confusion (rails#738,
and the closed rails#739 and rails#774), so spell it out in the dynamic tasks
section.

@rosa rosa left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great, thank you!

@rosa
rosa merged commit 2a479f6 into rails:main Jul 30, 2026
55 of 58 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants