Skip to content

docs: document connecting Azure Private Link to native Azure resources#3138

Open
jwhartley wants to merge 3 commits into
masterfrom
docs/azure-privatelink-paas-resources
Open

docs: document connecting Azure Private Link to native Azure resources#3138
jwhartley wants to merge 3 commits into
masterfrom
docs/azure-privatelink-paas-resources

Conversation

@jwhartley

Copy link
Copy Markdown
Contributor

Summary

  • The Azure Private Link page only documented building a customer-managed Private Link Service + Load Balancer. In practice, several data planes link directly to native Azure PaaS resources (SQL Managed Instance, Storage Accounts, SQL servers) via Private Link's sub-resource type ("group ID"), which was undocumented and could lead customers to build unnecessary Load Balancer infrastructure for resources that support Private Link natively.
  • Also documents the optional DNS name field: if a customer provides one, Estuary provisions a private DNS zone and points it at the endpoint automatically, instead of handing back a bare IP.

Test plan

  • Docs-only change, no code paths affected
  • Preview the rendered page locally (npm run start in site/) and confirm the new "Connecting to a native Azure resource" subsection renders correctly under Azure Private Link

The Azure Private Link page only covered building a customer-managed
Private Link Service, but est-dry-dock also supports linking directly
to a PaaS resource (SQL, Storage, etc.) via its sub-resource type, and
optionally provisioning a DNS name for the endpoint. Neither was
documented.
@jwhartley jwhartley added the docs Documentation work required label Jul 9, 2026
@jwhartley jwhartley requested a review from aeluce July 9, 2026 04:46
@jwhartley

Copy link
Copy Markdown
Contributor Author

Note for whoever picks this up next: we're hoping to ship self-service private link setup this quarter (Q3 2026). Once that lands, this page (and the customer-facing PrivateLink instructions in general) should be revisited since the manual request flow described here may no longer be the primary path.

@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown

🚀 Preview deployed to https://docs.estuary.dev/pr-preview/pr-3138/

📄 Changed pages:

aeluce
aeluce previously approved these changes Jul 10, 2026

@aeluce aeluce left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

The structure of the section may make it confusing on what's required for one method or another, since there's no indication when the PaaS resource section ends and the two threads come together again.

I pushed a possible solution that reorders the information. If that doesn't seem quite right, another option would be to use tabs.

Though as you say, self-service is coming soon and that sounds great.

Trim redundant phrasing after the PaaS-resource restructuring: fix an
ungrammatical intro clause, cut a restatement the two fork bullets
already cover, and de-duplicate the sub-resource-type examples that
appeared both in the shared checklist and the detail section below it.
@jwhartley

jwhartley commented Jul 10, 2026

Copy link
Copy Markdown
Contributor Author

Hey @aeluce I tweaked it slightly to make it a little more succinct and readable if you wouldn't mind re-reviewing.
FYI this question (Azure storage private linking) came up today again for second customer this week - it's come up maybe twice in all history before this week but we're seeing some more POCs on Azure

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

Labels

docs Documentation work required

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants