Skip to content

Workflows: add info that in local dev, pause and resume methods are not available #19988

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: production
Choose a base branch
from
Open

Workflows: add info that in local dev, pause and resume methods are not available #19988

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
77ce7bc
add info that for Workflows, in local dev, pause and resume methods …
bruxodasilva Feb 14, 2025
e8b0ef9
Merge branch 'production' into dferreira-workflows-localdev-limitations
bruxodasilva Apr 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion src/content/docs/workers/local-development.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,14 +48,16 @@ npx wrangler dev
| Rate Limiting | ✅ | ✅ |
| Service Bindings (multiple workers) | ✅ | ✅ |
| Vectorize | ✅[^2] | ✅ |
| Workflows | ✅ | ❌ |
| Workflows | ✅[^3] | ❌ |

With any bindings that are not supported locally, you will need to use the [`--remote` command](#develop-using-remote-resources-and-bindings) in wrangler, such as `wrangler dev --remote`.

[^1]: Using Workers AI always accesses your Cloudflare account in order to run AI models and will incur usage charges even in local development.

[^2]: Using Vectorize always accesses your Cloudflare account to run queries, and will incur usage charges even in local development.

[^3]: `pause()` and `resume()` are not available in local development.
Copy link
Contributor

@irvinebroque irvinebroque Feb 14, 2025

Choose a reason for hiding this comment

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

If they're not in local dev, and Workflows doesn't work in remote dev, that means...you just have to write code ship to prod and trust it will work? Or am I missing something?

Copy link
Contributor

@sidharthachatterjee sidharthachatterjee Feb 14, 2025 •
edited
Loading

Choose a reason for hiding this comment

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

@irvinebroque No, you're correct. pause and resume are not supported locally. However, writing and running a WorkflowEntrypoint is. wrangler dev on a project that exports a WorkflowEntrypoint works and that's what I would classify as local development to assert if something works before shipping to production.

Pause and resume are unsupported at the moment due to a miniflare limitation (killing the engine DO kills all threads unless I'm mistaken). Pause and resume are also often not in the happy path for p90 Workflows use cases so we are happy with that being a foot note for now until we are unblocked.


## Work with local data

When running `wrangler dev`, resources such as KV, Durable Objects, D1, and R2 will be stored and persisted locally and not affect the production resources.
Expand Down