Kubernetes Pod CrashLoopBackOff 진단 — 원인별 완전 해결

kubectl get pods
# NAME        READY   STATUS             RESTARTS   AGE
# myapp-xxx   0/1     CrashLoopBackOff   5          3m

kubectl describe pod myapp-xxx

Last State:     Terminated
  Reason:       Error
  Exit Code:    1            ← 핵심 단서
Events:
  Warning  BackOff  ...  Back-off restarting failed container

kubectl logs myapp-xxx                 # 현재(또는 마지막) 인스턴스
kubectl logs myapp-xxx --previous      # 이전에 크래시한 인스턴스 ← 핵심
kubectl logs myapp-xxx -c sidecar      # 멀티 컨테이너 시 특정 컨테이너

kubectl logs myapp-xxx --previous
# 예: "ECONNREFUSED postgres:5432" → DB가 아직 안 떴거나 Service명 오타

initContainers:
- name: wait-db
  image: busybox:1.36
  command: ['sh','-c','until nc -z postgres 5432; do echo waiting; sleep 2; done']

kubectl describe pod myapp-xxx | grep -A3 'Last State'
#   Reason: OOMKilled

resources:
  requests: { memory: 256Mi }
  limits:   { memory: 512Mi }   # 실제 사용량 + 여유

kubectl logs myapp-xxx --previous
# "exec: \"node\": executable file not found" → 이미지에 없는 명령

kubectl run debug --rm -it --image=myapp:1.0 --command -- /bin/sh

livenessProbe:
  httpGet: { path: /healthz, port: 8080 }
  initialDelaySeconds: 30      # 부팅 느린 앱은 충분히
  periodSeconds: 10
  failureThreshold: 3
# 부팅이 매우 느리면 startupProbe로 분리
startupProbe:
  httpGet: { path: /healthz, port: 8080 }
  failureThreshold: 30
  periodSeconds: 5

kubectl describe pod myapp-xxx
# Warning  Failed  ... configmap "app-config" not found

# 이벤트를 시간순으로 — 클러스터 차원 원인(스케줄링/이미지풀) 파악
kubectl get events --sort-by=.lastTimestamp

# 임시로 죽지 않게 만들어 안에서 진단 (command를 sleep로 덮어쓰기)
kubectl run probe --rm -it --image=myapp:1.0 \
  --command -- sleep 3600
kubectl exec -it probe -- sh

# 기존 Pod에 디버그 컨테이너 주입(이미지 변경 없이)
kubectl debug -it myapp-xxx --image=busybox:1.36 --target=myapp