K8s_Troubleshooting_Guide

Kubernetes Pod Pending 원인 7가지: kubectl describe로 완벽 진단하는 실전 가이드

Pod가 Pending 상태로 멈춰 서비스 장애가 발생했을 때, 막연한 추측은 이제 그만입니다. 이 가이드는 kubectl describe를 활용하여 리소스 부족, Taint/To…

ImagePullBackOff/ErrImagePull 원인 6가지 진단·해결 가이드

Pod가 ImagePullBackOff/ErrImagePull에서 멈췄나요? kubectl describe로 Events를 읽어 이미지명 오타, imagePullSecrets 누락…

CrashLoopBackOff 해결: Pod 무한 재시작 7가지 원인 진단법

Pod가 CrashLoopBackOff로 계속 재시작된다면 kubectl describe와 logs --previous로 1분 만에 원인을 좁히세요. OOMKilled(Exit 1…

Pod Evicted "node was low on resource" 5분 진단·해결법

Pod가 Evicted되며 'node was low on resource' 에러가 뜬다면 범인은 컨테이너가 아니라 노드의 DiskPressure·MemoryPressure입니다. …

Kubernetes Pod가 Terminating에서 멈췄을 때: 원인 5가지와 안전한 강제 삭제

Kubernetes Pod가 Terminating에서 멈춰 삭제 안 될 때 finalizer·grace period·노드 NotReady·볼륨 detach 5가지 원인을 진단하고,…

OOMKilled exit code 137 해결: Pod 메모리 limit 진단부터 튜닝까지

Pod가 exit code 137 OOMKilled로 계속 재시작되나요? 노드 Evicted와의 차이, kubectl 진단, working set 측정, requests/limit…

Liveness/Readiness Probe 실패 6대 원인과 해결법: Pod 무한 재시작 잡기

앱은 정상인데 Pod가 CrashLoopBackOff로 재시작되거나 503이 뜨는 원인은 Probe 설정입니다. Liveness·Readiness·Startup 차이부터 6대 실패…

Kubernetes Pod DNS 실패(CoreDNS) 5분 진단: can't resolve & Temporary failure

Kubernetes Pod의 nslookup can't resolve, Temporary failure in name resolution DNS 실패를 CoreDNS·resolv.…

kubectl get nodes NotReady 원인 6가지 진단·복구 5분 가이드

워커 노드가 NotReady로 빠지고 Pod가 전부 죽었다면 kubelet 다운·CNI plugin not initialized·DiskPressure 등 6원인을 describe…

Kubernetes PVC Pending 안 풀릴 때 원인 6가지 5분 진단 가이드

kubectl get pvc가 계속 Pending이고 Pod가 ContainerCreating에 멈췄나요? no persistent volumes available, waiting…

kubectl Unauthorized(You must be logged in) 401 해결 6가지

kubectl 'You must be logged in to the server (Unauthorized)' 401 에러를 토큰 만료, context 오인, EKS aws-iam-…

Kubernetes CrashLoopBackOff 원인 7가지 — 종료코드로 5분 진단

Pod가 CrashLoopBackOff로 무한 재시작될 때 describe와 logs --previous로 종료코드(0/1/137/139)를 읽어 원인을 좁히는 5분 진단법. 7대…

kubectl get endpoints <none>·Service connection refused 5분 진단

Kubernetes Service에 connection refused·no endpoints가 뜬다면 Endpoints가 비어있는 게 원인입니다. selector 불일치, labe…

ImagePullBackOff·x509·unauthorized 사설 레지스트리 에러 5분 진단

Pod가 ImagePullBackOff·ErrImagePull에서 멈췄나요? x509 unknown authority·unauthorized 등 Harbor·Nexus 에러를 Ev…

Kubernetes PVC Pending 문제, StorageClass 매칭 실패 원인부터 완벽 디버깅 가이드

PVC가 'Pending' 상태에 머무는 가장 까다로운 원인, StorageClass 매칭 실패를 체계적으로 진단하는 가이드입니다. 필수 디버깅 명령어와 YAML 비교를 통해 스토…

ImagePullBackOff·ErrImagePull 해결: Events로 원인 진단하고 복붙으로 끝내기

kubectl ImagePullBackOff와 ErrImagePull을 Events 메시지 진단표로 5분 만에 특정합니다. imagePullSecrets 네임스페이스, privat…

CrashLoopBackOff 해결: kubectl로 Pod 재시작 무한루프 5분 진단

Pod가 CrashLoopBackOff로 무한 재시작될 때 kubectl describe와 logs --previous로 5분 안에 원인 찾기. Exit Code 1/2/126/1…

OOMKilled exit code 137 해결: kubectl 30초 진단·5분 복구 런북

Pod가 OOMKilled exit code 137로 죽었나요? kubectl describe·jsonpath·dmesg로 컨테이너 limit 초과인지 노드 메모리 압박인지 30초…

Pod Pending FailedScheduling 0/3 nodes 30초 진단·복구 런북

Pod가 FailedScheduling 0/3 nodes(insufficient cpu/memory·taint·node selector)로 Pending에 멈췄나요? Events …

K8s Liveness/Readiness probe failed·connection refused 원인별 해결

kubectl Events에 찍힌 Liveness/Readiness probe failed, connection refused, context deadline exceeded 에러…

kubectl Unauthorized 원인별 3분 진단·복구 런북 (EKS 재발급)

kubectl 'You must be logged in to the server (Unauthorized)' 에러를 토큰·인증서 만료, context·RBAC·엔드포인트 5가지로 …

kubectl localhost:8080 refused 에러 30초 진단·복구 런북

kubectl 'connection to localhost:8080 was refused' 에러를 30초 진단표와 복붙 명령으로 해결합니다. kubeconfig 경로·KUBECON…