Skip to content

[Hyperdrive, Workers] Configure placement near databases - #34186

Closed
irvinebroque wants to merge 3 commits into
productionfrom
bib/hyperdrive-placement-guidance
Closed

irvinebroque wants to merge 3 commits into
productionfrom
bib/hyperdrive-placement-guidance

Conversation

@irvinebroque

@irvinebroque irvinebroque commented Oct 10, 2026 •

Copy link
Copy Markdown
Contributor

Make explicit region placement part of Hyperdrive setup before deployment for Workers that make multiple sequential queries to a regional database.

Explain how to obtain the database provider and region, why Hyperdrive origin connection information does not automatically establish Worker placement, and how to handle unknown or multiple back-end locations.

Companion skills update: cloudflare/skills#230

@github-actions github-actions Bot added product:workers Related to Workers product product:hyperdrive Hyperdrive: https://developers.cloudflare.com/hyperdrive/ size/s labels Oct 10, 2026
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://bib-hyperdrive-placement-guidance.previews.developers.cloudflare.com (commit 132a0c0)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Failed ❌

View logs ↗
320bde0 2026-10-16T21:25:47.070Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://83db9c96.previews.developers.cloudflare.com 132a0c0 2026-10-10T19:47:08.855Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://78a84399.previews.developers.cloudflare.com e07cacd 2026-10-10T19:21:51.957Z Visit the dashboard ↗


<Render file="placement-hint-partial" product="hyperdrive" />

The [Hyperdrive configuration API](/api/resources/hyperdrive/subresources/configs/methods/get/) exposes origin connection information, but does not return the database's cloud region. Confirm that region with your database provider. For PlanetScale, refer to [Worker placement for PlanetScale](/hyperdrive/planetscale/#configure-worker-placement).

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
The [Hyperdrive configuration API](/api/resources/hyperdrive/subresources/configs/methods/get/) exposes origin connection information, but does not return the database's cloud region. Confirm that region with your database provider. For PlanetScale, refer to [Worker placement for PlanetScale](/hyperdrive/planetscale/#configure-worker-placement).


The [Hyperdrive configuration API](/api/resources/hyperdrive/subresources/configs/methods/get/) exposes origin connection information, but does not return the database's cloud region. Confirm that region with your database provider. For PlanetScale, refer to [Worker placement for PlanetScale](/hyperdrive/planetscale/#configure-worker-placement).

Placement affects [fetch event handlers](/workers/runtime-apis/handlers/fetch/). It does not place RPC methods or named entrypoints. Refer to [placement limitations](#placement-behavior) before choosing an application architecture.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
Placement affects [fetch event handlers](/workers/runtime-apis/handlers/fetch/). It does not place RPC methods or named entrypoints. Refer to [placement limitations](#placement-behavior) before choosing an application architecture.

@cloudflare-docs-bot

Copy link
Copy Markdown
Contributor

@irvinebroque This draft pull request has had no activity for 3 days. It will close after 7 days of inactivity. Transition to ready for review if ready. A codeowner can comment /draft-never-stale to keep it open.

@cloudflare cloudflare deleted a comment from github-actions Bot Oct 16, 2026
@cloudflare-docs-bot

Copy link
Copy Markdown
Contributor

@irvinebroque This draft pull request has had no activity for 3 days. It will close after 7 days of inactivity. Transition to ready for review if ready. A codeowner can comment /draft-never-stale to keep it open.

@cloudflare-docs-bot

Copy link
Copy Markdown
Contributor

@irvinebroque Closing this draft pull request after 7 days of inactivity. Re-open at a later date and transition to ready for review when you are ready if you seek review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:hyperdrive Hyperdrive: https://developers.cloudflare.com/hyperdrive/ product:workers Related to Workers product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants