rancher / rancher/stackstate-product-docs

[STAC-25140] Requirement docs are confusing (minimum node size and minimum node count)

Open
#393 0 comments 0 reactions 1 assignee View on GitHub

@akashraj4261 is already working on this.

Since Sep 15, 2026.

area/documentation JIRA kind/enhancement squad/marvin
Dominant language
Shell
Stars
2
Forks
24
Avg merge
4d 3h
Merged PRs (30d)
16

Description

STAC-25140

The minimum node size and minimum node count lead to confusion now. In at least one case it resulted in the expectation that (minimum node count) * (minimum node size) is all that’s required. Which is obviously incorrect. For example for trial: minimum node is 4vCPU and 8Gi memory, minimum count is 1, but a few rows higher it says memory requirement is 23.4Gi.

TBH I head to double check the table and the call-out underneath too to get the exact intention which is this (my words):

The minimum node size means that the nodes in the k8s cluster need to be at least of that size. The minimum node count means you need at least that amount of nodes. That doesn't mean you need only 1 node of minimum size (it still needs 23.4Gi of memory).

For HA deployments minimum node count is 3 because databases run with 3 replicas and they should run on 3 different nodes. Minimum node size can increase because there is a single pod that requires now that amount of memory or CPU.

Acceptance criteria*)

  • Offer the improved doc to Gustavo to see whether that would help him as a review

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.