-
Notifications
You must be signed in to change notification settings - Fork 182
Open
Description
Bug Description
The documentation in /docs/installation/requirements.md contains contradictory sizing information for control plane nodes that confuses users.
Contradictory Information
Server Sizing Guide table states:
- 2 CPU, 4 GB control plane → supports 0-350 agents
Large Clusters - CPU and Memory table states:
- Small clusters (up to 10 nodes) → 2 vCPUs, 4 GB per control plane
- Medium clusters (up to 100 nodes) → 4 vCPUs, 8 GB per control plane
The Problem
These tables contradict each other:
- First table: 2 CPU, 4GB can handle 350 workers (50% more in HA)
- Second table: 2 CPU, 4GB only good for 10 total nodes
It's unclear whether "nodes" in the second table includes control planes or refers only to total cluster size.
Suggested Fix
Clarify the documentation by:
- Defining whether "nodes" includes control planes or workers only
- Explaining why requirements differ between the tables
- Providing consistent terminology throughout
Impact
This confusion leads users to incorrectly size their control plane nodes and creates uncertainty about k3s scaling capabilities.
Metadata
Metadata
Assignees
Labels
No labels