-
Notifications
You must be signed in to change notification settings - Fork 468
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
base: main
Are you sure you want to change the base?
Conversation
✅ Deploy Preview for cockroachdb-interactivetutorials-docs canceled.
|
✅ Deploy Preview for cockroachdb-api-docs canceled.
|
✅ Netlify Preview
To edit notification comments on pull requests, go to your Netlify site configuration. |
- 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. |
There was a problem hiding this comment.
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?
There was a problem hiding this comment.
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 }}. |
There was a problem hiding this comment.
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.
Add clarity on when to use GCP endpoint name
b02ae18
to
34c2c72
Compare
- 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. |
There was a problem hiding this comment.
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?
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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
Add clarity on when to use GCP endpoint name