Skip to content

Update BYOC PrivateLink setup docs and screenshots (AWS & GCP)#6452

Open
luisliuchao wants to merge 3 commits into
mainfrom
6405-update-byoc-private-link-setup-screenshots
Open

Update BYOC PrivateLink setup docs and screenshots (AWS & GCP)#6452
luisliuchao wants to merge 3 commits into
mainfrom
6405-update-byoc-private-link-setup-screenshots

Conversation

@luisliuchao

Copy link
Copy Markdown
Contributor

Summary

Updates the BYOC private networking setup guides for AWS and GCP to reflect the new self-service PrivateLink / Private Service Connect flow driven from the ClickHouse Cloud console, replacing the older "contact ClickHouse Support" steps.

  • AWS (01_aws.md): Rewrites the PrivateLink section into a step-by-step, console-driven flow — enabling private link in the ClickHouse console, obtaining the endpoint service name, creating and approving the VPC endpoint, adding the Endpoint ID to the service allow list, and connecting via the DNS name. Adds screenshots for each step.
  • GCP (02_gcp.md): Parallel updates for the Private Service Connect flow.
  • Adds new images: byoc-private-load-balancer.png and byoc-privatelink.png.
  • Minor copy fixes (e.g. "Privatelink" → "PrivateLink") and spacing/formatting cleanup.

Test plan

  • Verify images render and steps read correctly in the docs preview.

🤖 Generated with Claude Code

@luisliuchao luisliuchao requested a review from a team as a code owner June 26, 2026 06:22
@luisliuchao luisliuchao linked an issue Jun 26, 2026 that may be closed by this pull request
@CLAassistant

CLAassistant commented Jun 26, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@vercel

vercel Bot commented Jun 26, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview Jun 26, 2026 9:53am
4 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-jp Ignored Ignored Jun 26, 2026 9:53am
clickhouse-docs-ko Ignored Ignored Preview Jun 26, 2026 9:53am
clickhouse-docs-ru Ignored Ignored Preview Jun 26, 2026 9:53am
clickhouse-docs-zh Ignored Ignored Preview Jun 26, 2026 9:53am

Request Review

@luisliuchao luisliuchao force-pushed the 6405-update-byoc-private-link-setup-screenshots branch from eedbd5a to 51d8d5f Compare June 26, 2026 06:25

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the BYOC private networking setup docs for AWS and GCP to reflect the new self-service PrivateLink / Private Service Connect flows driven from the ClickHouse Cloud console.

Changes:

  • Rewrites AWS PrivateLink setup steps to be console-driven (service name discovery, endpoint creation/approval, allowlisting, DNS name usage).
  • Rewrites GCP PSC setup steps similarly (published service lookup, connected endpoint creation, allowlisting, DNS name usage).
  • Adds/updates supporting screenshots and adjusts frontmatter keywords formatting.

Reviewed changes

Copilot reviewed 2 out of 4 changed files in this pull request and generated 4 comments.

File Description
docs/cloud/guides/infrastructure/01_deployment_options/byoc/03_onboarding/03_network_setup/01_aws.md Updates AWS BYOC networking guide with a self-service PrivateLink flow and new screenshots.
docs/cloud/guides/infrastructure/01_deployment_options/byoc/03_onboarding/03_network_setup/02_gcp.md Updates GCP BYOC networking guide with a self-service PSC flow, new screenshots, and refreshed structure.
Comments suppressed due to low confidence (2)

docs/cloud/guides/infrastructure/01_deployment_options/byoc/03_onboarding/03_network_setup/02_gcp.md:44

  • The “Enable private load balancer…” prerequisite currently only shows a screenshot and doesn’t tell the reader what action to take in the ClickHouse Cloud console. Adding a short instruction here would make the prerequisite self-contained.
To create or delete VPC peering for ClickHouse BYOC, follow the steps:

:::note

docs/cloud/guides/infrastructure/01_deployment_options/byoc/03_onboarding/03_network_setup/02_gcp.md:157

  • This section uses AWS terminology (“VPC Endpoint Security Group”). On GCP PSC there are no security groups on the endpoint; access from the consumer side is governed by your VPC/host firewall rules (in addition to ClickHouse Cloud authz).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 51d8d5f. Configure here.

@luisliuchao luisliuchao changed the title Update BYOC PrivateLink setup docs and screenshots (AWS & GCP) wip: Update BYOC PrivateLink setup docs and screenshots (AWS & GCP) Jun 26, 2026
@luisliuchao luisliuchao changed the title wip: Update BYOC PrivateLink setup docs and screenshots (AWS & GCP) Update BYOC PrivateLink setup docs and screenshots (AWS & GCP) Jun 26, 2026
@luisliuchao luisliuchao marked this pull request as draft June 26, 2026 09:03
@luisliuchao luisliuchao marked this pull request as ready for review June 26, 2026 09:11
@luisliuchao luisliuchao self-assigned this Jun 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(doc): Update BYOC private link setup screenshots

3 participants