Skip to content

Please improve docs for worker version key and overrides #21547

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.

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
Meai opened this issue Apr 9, 2025 · 0 comments
Open

Please improve docs for worker version key and overrides #21547

Meai opened this issue Apr 9, 2025 · 0 comments
Assignees
Labels
content:edit Request for content edits documentation Documentation edits product:workers Related to Workers product

Comments

@Meai
Copy link

Meai commented Apr 9, 2025

Existing documentation URL(s)

https://developers.cloudflare.com/workers/configuration/versions-and-deployments/gradual-deployments/

What changes are you suggesting?

  1. To me Cloudflare-Workers-Version-Key and Cloudflare-Workers-Version-Override both sound like they can change which worker will respond to a request. I don't know what the difference is, I can't tell how it influences the "affinity" or how it would somehow influence later requests just because I sent one request with a key. Does it mean per keep-alive connection or curl session somehow? I don't understand how it would achieve affinity.
  2. I just spent - it must have been almost 1.5h - to finally notice this seemingly innocent sentence A version override will only be applied if the specified version is in the current deployment and realizing that it carries a lot of weight. Because it's quite unintuitive that I'm saving a worker version and it is clearly deployed in some form because the preview url exists and it is running.. and yet in this context it doesn't count as deployed at all. It needs me to do a special "gradual" version deployment where I can then set one of the versions to 0% and the other remains at 100% and now they both count as deployed and the version with 0% can still receive requests via header override.
  3. Please also link to wherever the syntax was for doing this gradual deployment via wrangler cli, there was some kind of special syntax that I found somewhere but I can't find it anymore right now.
  4. Really sad that this only allows for version overrides for two versions. I want to target any of my deployed preview url versions via override. I need a header based override so that it works via service binding.

Additional information

No response

@Meai Meai added content:edit Request for content edits documentation Documentation edits labels Apr 9, 2025
@github-actions github-actions bot added the product:workers Related to Workers product label Apr 9, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content:edit Request for content edits documentation Documentation edits product:workers Related to Workers product
Projects
None yet
Development

No branches or pull requests

6 participants