Understanding pod.yaml: Anatomy, Best Practices, and Examples

Understanding pod.yaml: Anatomy, Best Practices, and Examples

A Pod is the smallest deployable unit in Kubernetes. pod.yaml declares containers, initContainers, volumes, probes, resources, and security contexts. Use explicit probes and resource requests to ensure stability.

Minimal Production pod.yaml Example

Includes initContainer for migrations, two app containers (app + sidecar), liveness/readiness probes, resource requests/limits, and ConfigMap/Secret mounts.

Best Practices

• Always set liveness and readiness probes.
• Define resource requests and limits to avoid noisy neighbors.
• Use initContainers for one-time setup tasks.
• Mount ConfigMaps and Secrets for configuration and credentials.
• Apply securityContext and run as non-root where possible.

Common Patterns

• Sidecar pattern for logging/agents.
• Ambassador/adapter sidecars for protocol translation.
• Anti-pattern: packing unrelated services into one Pod.