Added info about no support for 2vcpu clusters #20119
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Added line to show lack of support for 2vcpu clusters
Files changed: |
✅ 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 project configuration. |
✅ Netlify Preview
To edit notification comments on pull requests, go to your Netlify project configuration. |
jhlodin
reviewed
Aug 13, 2025
| @@ -40,7 +40,7 @@ If your cluster's workload is subject to [compliance]({% link cockroachcloud/com | |||
|
|
|||
| A cluster's number of nodes and node capacity together determine the node's total compute and storage capacity. | |||
|
|
|||
| When considering your cluster's scale, we recommend that you start by planning the compute requirements per node. If a workload requires more than 16 vCPUs per node, consider adding more nodes. For example, if a 3-node cluster with 8 vCPUs per node is not adequate for your workload, consider scaling up to 16 vCPUs before adding a fourth node. For most production applications, we recommend at minimum 8 vCPUs per node. | |||
| When considering your cluster's scale, we recommend that you start by planning the compute requirements per node. If a workload requires more than 16 vCPUs per node, consider adding more nodes. For example, if a 3-node cluster with 8 vCPUs per node is not adequate for your workload, consider scaling up to 16 vCPUs before adding a fourth node. For most production applications, we recommend at minimum 8 vCPUs per node. We do not provide support for clusters with only 2 vCPUs per node. | |||
There was a problem hiding this comment.
I think this note is better served as a warning banner below this paragraph, given that it came up frequently enough that PM requested an explicit callout.
You can search the docs for instances of site.data.alerts.callout_danger for the syntax for this.
Moved information to warning block
|
Screenshot of how the change will look on the docs site: |
jhlodin
approved these changes
Aug 14, 2025
| When considering your cluster's scale, we recommend that you start by planning the compute requirements per node. If a workload requires more than 16 vCPUs per node, consider adding more nodes. For example, if a 3-node cluster with 8 vCPUs per node is not adequate for your workload, consider scaling up to 16 vCPUs before adding a fourth node. For most production applications, we recommend at minimum 8 vCPUs per node. | ||
|
|
||
| {{site.data.alerts.callout_danger}} | ||
| We do not provide support for clusters with only 2 vCPUs per node. |
There was a problem hiding this comment.
Discussed offline - we ought to be very particular about if/when to use 'we' in this context, and in this case because it is a support policy in the contract I think this should say 'Cockroach Labs does not provide support... '
devarshishah3
approved these changes
Aug 14, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Addresses: DOC-14350
Changed: Added line to show lack of support for 2vcpu clusters