Skip to content

[Workers] Split version overrides into dedicated page, add service bindings guidance#30737

Merged
yomna-shousha merged 8 commits into
productionfrom
yomna/version-overrides-service-bindings
May 11, 2026
Merged

[Workers] Split version overrides into dedicated page, add service bindings guidance#30737
yomna-shousha merged 8 commits into
productionfrom
yomna/version-overrides-service-bindings

Conversation

@yomna-shousha
Copy link
Copy Markdown
Contributor

@yomna-shousha yomna-shousha commented May 11, 2026

Summary

  • Extracts the Version overrides section from gradual-deployments.mdx into its own dedicated page (version-overrides.mdx)
  • Adds a new Service bindings section documenting that Cloudflare-Workers-Version-Overrides works on service-binding fetch() subrequests
  • Clarifies that the header is not automatically propagated — the calling Worker must explicitly set it
  • Adds a note that version overrides do not work with RPC calls (env.MY_SERVICE.someMethod()), since RPC has no mechanism for attaching headers
  • Fixes a broken link in previews.mdx to point to the new page

Context

This builds on the work in #30733 by @thomsoncf — same customer feedback

Verified

Deployed two Workers (caller + callee) with a service binding and gradual deployment (v1=100%, v2=0%). Confirmed:

Scenario Result
No override header callee returns v1
Caller explicitly sets override → v2 on env.CALLEE.fetch() callee returns v2

Files changed

  • New: version-overrides.mdx — dedicated version overrides page with service bindings section
  • Modified: gradual-deployments.mdx — replaced version overrides section with link to new page
  • Modified: previews.mdx — updated link to point to new page

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 11, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @cloudflare/wrangler, @mattietk, @cloudflare/dev-plat-leads

…s/gradual-deployments.mdx

Co-authored-by: Greg Brimble <gbrimble@cloudflare.com>
…s/version-overrides.mdx

Co-authored-by: Greg Brimble <gbrimble@cloudflare.com>
…s/version-overrides.mdx

Co-authored-by: Greg Brimble <gbrimble@cloudflare.com>
yomna-shousha and others added 2 commits May 11, 2026 16:40
…s/version-overrides.mdx

Co-authored-by: Greg Brimble <gbrimble@cloudflare.com>
…s/version-overrides.mdx

Co-authored-by: Greg Brimble <gbrimble@cloudflare.com>
@yomna-shousha yomna-shousha enabled auto-merge (squash) May 11, 2026 21:01
@yomna-shousha yomna-shousha merged commit a05970e into production May 11, 2026
15 checks passed
@yomna-shousha yomna-shousha deleted the yomna/version-overrides-service-bindings branch May 11, 2026 21:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:workers Related to Workers product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants