study.

Pod 장애 진단의 첫 5분 · CKA

상태 → 이벤트 → 로그 순서로 관찰하고, 추측 대신 증거를 모읍니다.

← 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과 대조합니다. 실행 전 구성 실패에는 애플리케이션 로그가 없는 것이 자연스럽습니다.

잠깐, 이해했는지 확인해볼까요?

재시작 전 컨테이너의 로그를 보려면?

  1. kubectl get logs
  2. kubectl logs POD --previous
  3. kubectl describe node
  4. kubectl logs POD --future
생각해본 뒤 풀이 보기

kubectl logs POD --previous

--previous는 이전에 종료된 컨테이너 인스턴스의 로그를 요청합니다.

Kubernetes 공식 문서