Skip to content

Malonso/hyperdrive vpc docs#29343

Open
xortive wants to merge 3 commits intocloudflare:productionfrom
xortive:malonso/hyperdrive-vpc-docs
Open

Malonso/hyperdrive vpc docs#29343
xortive wants to merge 3 commits intocloudflare:productionfrom
xortive:malonso/hyperdrive-vpc-docs

Conversation

@xortive
Copy link
Copy Markdown
Contributor

@xortive xortive commented Mar 25, 2026

Documents three new wrangler features for Workers VPC and Hyperdrive: TCP service type, TLS certificate verification mode, and Hyperdrive integration via --service-id.

  • TCP service type: Add docs for --type tcp, --tcp-port, and --app-protocol (postgresql/mysql) across VPC Services concept page, Terraform page, and get-started guide. Removes "coming soon" language for TCP support.
  • TLS certificate verification mode: Document --cert-verification-mode (verify_full, verify_ca, disabled) with guidance on self-signed certificates and private CAs. Notes that custom CA upload is not yet supported.
  • Hyperdrive + Workers VPC integration: New how-to page (connect-to-private-database-vpc.mdx) showing how to use --service-id on wrangler hyperdrive create to connect to a private database through a TCP VPC Service, as a simpler alternative to the Tunnel+Access approach.
  • New example: End-to-end example (workers-vpc/examples/private-database.mdx) for connecting a Worker to a private PostgreSQL database using Workers VPC + Hyperdrive.
  • Cross-references added between Hyperdrive and Workers VPC docs so users can discover both private database approaches.

Screenshots (optional)

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects. (N/A — no renames or moves, only new pages and edits to existing pages.)

@xortive
fix: correct broken anchor links and style issues in Workers VPC docs
88310ab 
- Fix two broken cross-reference anchors in Terraform page
  (#configuration-example -> #configuration-examples)
- Replace 'etc.' with 'and others' in Workers VPC overview
@github-actions github-actions bot added product:hyperdrive Hyperdrive: https://developers.cloudflare.com/hyperdrive/ product:workers-vpc size/l labels Mar 25, 2026
@xortive xortive mentioned this pull request Mar 25, 2026
Merged
5 tasks
@xortive
[Workers VPC] Document TCP services, TLS cert verification, and Hyper…
1352813 
…drive integration

Add documentation for three new wrangler features:

- TCP service type for VPC Services (--type tcp, --tcp-port, --app-protocol)
  including host:port convenience syntax on --hostname for TCP services
- TLS certificate verification mode (--cert-verification-mode) with
  guidance on self-signed certificates and private CAs
- Hyperdrive integration via --service-id for connecting to private
  databases through Workers VPC

New pages:
- hyperdrive/configuration/connect-to-private-database-vpc.mdx
- workers-vpc/examples/private-database.mdx

Updated pages:
- workers-vpc/configuration/vpc-services/index.mdx (TCP type, TLS verification)
- workers-vpc/configuration/vpc-services/terraform.mdx (TCP and TLS examples)
- workers-vpc/get-started.mdx (TCP service creation in CLI tab)
- workers-vpc/index.mdx (mention TCP and database support)
- hyperdrive/configuration/connect-to-private-database.mdx (cross-ref to VPC approach)
- hyperdrive/get-started.mdx (link both private DB approaches in prereqs)
@alainsignorelli59-cmd
Copy link
Copy Markdown

alainsignorelli59-cmd commented Mar 25, 2026 via email

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Hey there, we've marked this pull request as stale because there's no recent activity on it. This label helps us identify PRs that might need updates (or to be closed out by our team if no longer relevant).

@github-actions github-actions bot added the stale label Apr 9, 2026
@sejoker
Copy link
Copy Markdown
Contributor

sejoker commented Apr 13, 2026

it's superseded by #29623.

@github-actions github-actions bot removed the stale label Apr 14, 2026
@xortive xortive force-pushed the malonso/hyperdrive-vpc-docs branch from 0d998cf to 1352813 Compare April 16, 2026 16:31
@xortive
[Hyperdrive] Add migration guide and refine VPC docs tradeoffs
44ac457 
Adds a how-to for migrating from Tunnel + Access to Workers VPC with two
approaches (new config with gradual rollout vs. in-place update), and
updates the private database docs to cross-link the migration guide and
mark Workers VPC as recommended. Revises the option comparison table so
the tradeoffs match the actual behavior described in each option's
'What happens during the update' section.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@elithrar elithrar Awaiting requested review from elithrar elithrar is a code owner

@thomasgauvin thomasgauvin Awaiting requested review from thomasgauvin thomasgauvin is a code owner

@sejoker sejoker Awaiting requested review from sejoker sejoker is a code owner

@Oxyjun Oxyjun Awaiting requested review from Oxyjun Oxyjun is a code owner

At least 1 approving review is required to merge this pull request.

Assignees

@elithrar elithrar

@sejoker sejoker

@thomasgauvin thomasgauvin

@Oxyjun Oxyjun

Labels

product:hyperdrive Hyperdrive: https://developers.cloudflare.com/hyperdrive/ product:workers-vpc size/l

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

6 participants

@xortive @alainsignorelli59-cmd @sejoker @elithrar @thomasgauvin @Oxyjun