Skip to content
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

Update connect-to-an-advanced-cluster.md #19445

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

devarshishah3
Copy link
Contributor

Add clarity on when to use GCP endpoint name

Copy link

Copy link

netlify bot commented Mar 12, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 550868c
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-interactivetutorials-docs/deploys/67d2e555e39f770008b44c66

Copy link

netlify bot commented Mar 12, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 550868c
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-api-docs/deploys/67d2e55579f2b70008f20086

Copy link

netlify bot commented Mar 12, 2025

Netlify Preview

Name Link
🔨 Latest commit 550868c
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-docs/deploys/67d2e5555858390008602f3a
😎 Deploy Preview https://deploy-preview-19445--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Comment on lines 57 to 58
- If it is not enabled, enable the Service Directory API, click **Enable global access**, and create a namespace in each region where your cluster is deployed. If the Service Directory API is not enabled, click Enable global access and create a namespace in each region where your cluster is deployed.
When Service Directory and Global access are enabled, GCP automatically maps your private endpoint IPs to approved DNS names.CockroachDB Cloud requires DNS name in your connection info to match the approved pattern in your cluster’s certificates. With Service Directory and Global Access features enabled, you can simply replace `<ENTER-ENDPOINT-NAME>` in your connection information with the assigned name of the Endpoint name used in the above step.

Choose a reason for hiding this comment

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

It looks like there's some redundancy here. Did you mean to remove the first sentence entirely?

Copy link
Contributor

Choose a reason for hiding this comment

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

@jaylim-crl Could you PTAL, I've made a few small adjustments.

@@ -54,7 +54,8 @@ Private connectivity can be configured only after a cluster is created.
- Set **Target** to **Published service**.
- Set **Target service** to the value you copied from CockroachDB {{ site.data.products.cloud }} Console. If the endpoint's configured target service does not match, validation will fail.
- Provide a value for **Endpoint name**. This is not used by CockroachDB {{ site.data.products.cloud }}.

Choose a reason for hiding this comment

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

Can we remove this sentence? We actually do use this value as part of the host name you connect to.

devarshishah3 and others added 2 commits March 12, 2025 16:43
Add clarity on when to use GCP endpoint name
@katmayb katmayb force-pushed the devarshishah3-patch-6 branch from b02ae18 to 34c2c72 Compare March 12, 2025 21:06
@katmayb katmayb requested a review from jaylim-crl March 13, 2025 14:02
- If it is not enabled, enable the Service Directory API, click **Enable global access**, and create a namespace in each region where your cluster is deployed.
- If it is not enabled, enable the Service Directory API. Click **Enable global access**, and create a namespace in each region where your cluster is deployed.

When Service Directory and Global access are enabled, GCP automatically maps your private endpoint IPs to approved DNS names. CockroachDB {{ site.data.products.cloud }} requires DNS names in your connection information to match the approved pattern in your cluster’s certificates. Replace `<ENTER-ENDPOINT-NAME>` in your connection information with the assigned **Endpoint name** used in the previous step.

Choose a reason for hiding this comment

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

It looks like we have not introduced <ENTER-ENDPOINT-NAME> at this point, and the user is still configuring their private endpoint. Should we remove the last sentence?

Copy link
Contributor

Choose a reason for hiding this comment

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

Hmm, @devarshishah3 as per @jaylim-crl's comment above, are you referring to entering the endpoint name in the CockroachDB Cloud Console here? If so, I can clarify.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

is required when the user clicks the CONNECT modal and has to composes the connection string

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.

4 participants