Diegolden

Topic 1: Kubernetes Components

2 min read

Topic 1: Kubernetes Components

Official baseline: (The Kubernetes Authors, 2026). My working version: A Kubernetes cluster is not a single daemon. It is a small distributed operating system with an API, a database, reconcilers, and agents on each machine.

Mental Model

A Kubernetes cluster is not a single daemon. It is a small distributed operating system with an API, a database, reconcilers, and agents on each machine.

Notes

  • Control plane components decide and record intent.
  • Node components execute that intent on real machines.
  • Addons make the cluster useful: DNS, metrics, networking, and dashboards live around the core.

Homelab Angle

In a homelab, this is the map you use when something breaks. Is the API down, is scheduling stuck, or did kubelet fail on one node?

Verify It

  • Read the object status before changing the manifest.
  • Check events for the controller or node that is actually complaining.
  • Confirm the official source linked below still matches the cluster version you run.

Common Failure Modes

  • Treating the YAML object as the system, instead of one input to a reconciliation loop.
  • Debugging from outside the cluster when the failure only exists inside cluster networking or node state.
  • Forgetting that Kubernetes version, addon version, and runtime behavior are linked.

Sources

  • Kubernetes Components - source path: content/en/docs/concepts/overview/components.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0.
  • Kubernetes documentation is licensed under CC BY 4.0; these notes are original commentary and link back to the official source.
The Kubernetes Authors. (2026). Kubernetes Components. https://kubernetes.io/docs/concepts/overview/components/

Graph View

Backlinks