Search across all documentation pages
Keep traffic off bad pods and size containers. Results appear in the same fence: same-line # comments when short, multiline # blocks below the sample when not. Fences are bash, dockerfile, or yaml as appropriate.
Controls Service Endpoints membership.
readinessProbe:
httpGet: { path: /ready, port: 8080 }
periodSeconds: 5
# not ready => removed from ServiceRestart container when stuck.
livenessProbe:
httpGet: { path: /healthz, port: 8080 }
failureThreshold: 3
# kubelet restarts after failuresDelay other probes during slow start.
startupProbe:
httpGet: { path: /healthz, port: 8080 }
failureThreshold: 30
periodSeconds: 5
# up to ~150s startupCPU/memory requests and limits.
resources:
requests: { cpu: "100m", memory: "128Mi" }
limits: { cpu: "500m", memory: "256Mi" }
# scheduler uses requests; limit caps usageGuaranteed when requests==limits for all.
# requests=limits for cpu+memory => Guaranteed QoS
# else Burstable or BestEffortPort-open probe without HTTP.
readinessProbe:
tcpSocket: { port: 5432 }
# succeeds if TCP connect worksRun a command in the container.
livenessProbe:
exec: { command: ["pg_isready", "-U", "postgres"] }
# exit 0 = healthyLegacy delay before probes (prefer startupProbe).
livenessProbe:
initialDelaySeconds: 20
httpGet: { path: /healthz, port: 8080 }
# waits 20s before first probeProbe timeout.
readinessProbe:
timeoutSeconds: 2
httpGet: { path: /ready, port: 8080 }
# fail if slower than 2sConsecutive failures to mark failed.
failureThreshold: 3
# 3 fails => not ready / restartSuccesses required after failure (readiness).
successThreshold: 1
# one success returns to readyRequest disk for emptyDir logs/cache.
resources:
requests: { ephemeral-storage: "1Gi" }
limits: { ephemeral-storage: "2Gi" }
# eviction if over limitSpecial memory resource (when enabled).
resources:
requests: { hugepages-2Mi: "100Mi" }
# node must provide hugepagesProbe cluster-local Service, not public edge, when possible.
# readiness on /ready internal onlyExceed memory limit => OOMKilled restart.
# kubectl describe pod ... Last State: OOMKilledStack versions: Kubernetes 1.36.2 · Docker Engine 29.6.1 · Helm 3 · Compose v2 · containerd via CRI
Reviewed by Chris St. John·Last updated Jul 18, 2026