Pod 장애 진단의 첫 5분 · CKA
상태 → 이벤트 → 로그 순서로 관찰하고, 추측 대신 증거를 모읍니다.
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
상태와 이벤트
Pending·ImagePullBackOff·CrashLoopBackOff는 서로 다른 조사 출발점입니다. describe의 Events가 스케줄링이나 이미지 다운로드 단서를 줍니다.
현재 로그와 이전 로그
계속 재시작하는 컨테이너는 --previous로 이전 인스턴스의 로그를 확인할 수 있습니다. 이전 인스턴스가 없으면 조회되지 않습니다.
왜 필요한가요?
“Pod가 안 뜬다”는 증상을 배치 실패·이미지 준비 실패·프로세스 종료·준비 상태 실패로 나누면 불필요한 재시작을 줄일 수 있습니다.
차례대로 이해하기
상태에서 첫 분기 선택
Pending이면 PodScheduled와 Events, ImagePullBackOff면 이미지 참조와 pull 이벤트를 봅니다. CrashLoopBackOff는 반복 재시작의 대기 상태이므로 종료 사유·종료 코드와 이전 실행 로그를 확인합니다.
시간과 컨테이너 연결
get -o yaml의 containerStatuses에서 실패한 컨테이너를 찾고 logs -c로 선택합니다. --previous는 해당 컨테이너의 이전 인스턴스 로그이며 오래된 모든 기록을 조회하는 옵션은 아닙니다. 이벤트 시각과 재시작 횟수를 함께 메모하세요.
직접 실행하며 익혀보세요.
kubectl과 연결 가능한 개인 실습용 Kubernetes 클러스터가 필요합니다. 각 실습은 독립적이며, 먼저 현재 context를 확인하세요. 명령어는 자신의 터미널에서 실행합니다.
Pod 목록에서 조사할 대상을 골라 아래 POD_NAME과 NAMESPACE를 실제 값으로 바꿔 실행하세요.
kubectl get pods -A
kubectl describe pod POD_NAME -n NAMESPACE
kubectl logs POD_NAME -n NAMESPACE --tail=50
kubectl logs POD_NAME -n NAMESPACE --previous --tail=50
kubectl get events -n NAMESPACE --sort-by=.metadata.creationTimestamp이렇게 확인하세요
관찰한 증상, 근거, 다음 조사 명령을 각각 한 줄로 적어보세요. 여러 컨테이너가 있으면 -c로 대상을 지정합니다.
응용해보기
로그가 비어 있고 CreateContainerConfigError입니다. 앱 소스 코드를 먼저 고칠까요?
생각해본 뒤 풀이 보기
컨테이너가 아직 실행되지 않았을 수 있습니다. Events에서 누락된 Secret·ConfigMap·키 등 설정 참조를 확인하고 spec과 대조합니다. 실행 전 구성 실패에는 애플리케이션 로그가 없는 것이 자연스럽습니다.
잠깐, 이해했는지 확인해볼까요?
재시작 전 컨테이너의 로그를 보려면?
- kubectl get logs
- kubectl logs POD --previous
- kubectl describe node
- kubectl logs POD --future
생각해본 뒤 풀이 보기
kubectl logs POD --previous
--previous는 이전에 종료된 컨테이너 인스턴스의 로그를 요청합니다.