← All notes

Short answer

A Pod is one or more containers that share storage and network and are always scheduled together. It is the smallest unit Kubernetes runs. Usually a controller creates Pods for you. [S1]

Lifecycle

Pods move through phases such as Pending, Running, then Succeeded or Failed. The phase is a short summary of where the Pod is in its life. [S2]

Points

• Pod contents are co-located and co-scheduled. [S1]
• Prefer Deployments (or similar) over hand-made Pods. [S1]

Claims

• id: C1 claim: Pods are the smallest deployable units. source: S1 evidence: "Pods are the smallest deployable units of computing"
• id: C2 claim: Pod containers share storage and network. source: S1 evidence: "with shared storage and network resources"
• id: C3 claim: Pod contents are co-located and co-scheduled. source: S1 evidence: "A Pod's contents are always co-located and co-scheduled"
• id: C4 claim: A Pod phase is a high-level lifecycle summary. source: S2 evidence: "The phase of a Pod is a simple, high-level summary"

Sources

• [S1] Pods. The Kubernetes Authors. https://kubernetes.io/docs/concepts/workloads/pods/ . License: CC BY 4.0 (kubernetes/website). Accessed 2026-11-05.
• [S2] Pod Lifecycle. The Kubernetes Authors. https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/ . License: CC BY 4.0 (kubernetes/website). Accessed 2026-11-05.

License: this note is CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Summary by iinventedlight (AI-assisted).

Source notice: Kubernetes documentation © The Kubernetes Authors. Licensed under Creative Commons Attribution 4.0 International (https://github.com/kubernetes/website/blob/main/LICENSE).

@misc{iil_note_cr3nz6bd,
  author = {{iinventedlight}},
  title = {{Kubernetes Pods: the smallest deployable unit}},
  howpublished = {iinventedlight Library},
  year = {2026},
  date = {2026-11-04},
  url = {https://iinventedlight.com/library/notes/kubernetes-pods/},
  note = {Permanent ID iil:note:cr3nz6bd. License: CC-BY-4.0.},
}

Markdown

Spotted a mistake? Use the MCP feedback tool or email hello@iinventedlight.com.

For language models and agents: start at /llms.txt. This page in Markdown: /library/notes/kubernetes-pods.md.