Skip to content

Commit acba209

Browse files
authored
Mention remote bindings do not work with RPC yet (#24003)
* mention remote bindings with rpc limitation * fixup phrasing and add workflows
1 parent 8168919 commit acba209

File tree

2 files changed

+10
-8
lines changed

2 files changed

+10
-8
lines changed

src/content/docs/workers/development-testing/index.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -302,11 +302,15 @@ If `experimental_remote: true` is specified in Wrangler configuration for any of
302302

303303
- [**Durable Objects**](/workers/wrangler/configuration/#durable-objects): Enabling remote connections for Durable Objects may be supported in the future, but currently will always run locally.
304304

305+
- [**RPC on service bindings**](/workers/runtime-apis/bindings/service-bindings/rpc/): While you can make `fetch()` calls on remote service bindings, you cannot currently call RPC methods on remote service bindings.
306+
307+
- [**Workflows**](/workflows/): Enabling remote connections for Workflows may be supported in the future, but currently will only run locally.
308+
305309
- [**Environment Variables (`vars`)**](/workers/wrangler/configuration/#environment-variables): Environment variables are intended to be distinct between local development and deployed environments. They are easily configurable locally (such as in a `.dev.vars` file or directly in Wrangler configuration).
306310

307311
- [**Secrets**](/workers/wrangler/configuration/#secrets): Like environment variables, secrets are expected to have different values in local development versus deployed environments for security reasons. Use `.dev.vars` for local secret management.
308312

309-
- **[Static Assets](/workers/wrangler/configuration/#assets)**: Static assets are always served from your local disk during development for speed and direct feedback on changes.
313+
- [**Static Assets**](/workers/wrangler/configuration/#assets) Static assets are always served from your local disk during development for speed and direct feedback on changes.
310314

311315
- [**Version Metadata**](/workers/runtime-apis/bindings/version-metadata/): Since your Worker code is running locally, version metadata (like commit hash, version tags) associated with a specific deployed version is not applicable or accurate.
312316

src/content/partials/workers/bindings_per_env.mdx

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@
44

55
## Local development
66

7-
During local development, your Worker code always executes locally and bindings connect to locally simulated resources [by default](/workers/development-testing/#remote-bindings).
7+
**Local simulations**: During local development, your Worker code always executes locally and bindings connect to locally simulated resources [by default](/workers/development-testing/#remote-bindings). This is supported in [`wrangler dev`](/workers/wrangler/commands/#dev) and the [Cloudflare Vite plugin](/workers/vite-plugin/).
88

9-
You can configure [**remote bindings** during local development](/workers/development-testing/#remote-bindings), allowing your bindings to connect to a deployed resource on a per-binding basis.
9+
**Remote binding connections:**: Allows you to connect to remote, deployed resources on a per-binding basis. Supported in [`wrangler dev --x-remote-bindings`](/workers/development-testing/#using-wrangler-with-remote-bindings) and the [Cloudflare Vite plugin](/workers/development-testing/#using-vite-with-remote-bindings).
1010

1111
| Binding | Local simulations | Remote binding connections |
1212
| --------------------------------------- | :---------------: | :------------------------: |
@@ -25,13 +25,11 @@ You can configure [**remote bindings** during local development](/workers/develo
2525
| **Queues** |||
2626
| **R2** |||
2727
| **Rate Limiting** |||
28-
| **Service Bindings (multiple Workers)** || |
28+
| **Service Bindings (multiple Workers)** || [^1] |
2929
| **Vectorize** |||
30-
| **Workflows** || |
30+
| **Workflows** || |
3131

32-
- **Local simulations:** Bindings connect to local resource simulations. Supported in [`wrangler dev`](/workers/wrangler/commands/#dev) and the [Cloudflare Vite plugin](/workers/vite-plugin/).
33-
34-
- **Remote binding connections:** Bindings connect to remote resources via `experimental_remote: true` configuration. Supported in [`wrangler dev --x-remote-bindings`](/workers/development-testing/#using-wrangler-with-remote-bindings) and the [Cloudflare Vite plugin](/workers/development-testing/#using-vite-with-remote-bindings).
32+
[^1]: While you can make `fetch()` calls on remote service bindings, you cannot currently call RPC methods on remote service bindings.
3533

3634
## Remote development
3735

0 commit comments

Comments
 (0)