study.

NotReady 노드 조사하기 · CKA

노드 상태부터 시작해 kubelet과 런타임까지 문제 범위를 좁힙니다.

← CKA

진도·퀴즈와 함께 학습하기

먼저, 개념을 잡아볼게요.

Node conditions

Ready·MemoryPressure·DiskPressure·PIDPressure 등의 조건과 Events를 살펴봅니다. NotReady만으로 특정 원인을 단정하지 않습니다.

호스트 조사

kubelet 로그, 컨테이너 런타임 상태, 디스크와 네트워크를 확인합니다. 호스트 명령은 해당 노드에 접근 권한이 있을 때 실행합니다.

왜 필요한가요?

한 Pod만 실패하는지 같은 노드의 여러 Pod가 실패하는지를 먼저 나누세요. 영향 범위는 앱 설정 문제와 노드 공통 문제를 구분하는 단서입니다.

차례대로 이해하기

조건과 시각 읽기

Node의 Ready와 MemoryPressure, DiskPressure, PIDPressure를 읽고 마지막 전환 시각·이벤트를 확인합니다. Ready가 Unknown이면 상태 보고 경로도 의심해야 하며, 노드 자체가 꺼졌다고 곧바로 확정할 수 없습니다.

호스트 근거 모으기

접근 가능한 실습 노드에서 kubelet·런타임 상태, 최근 로그, 파일시스템 용량을 확인합니다. 디스크 여유가 있어도 inode 고갈이 가능하므로 df -i 같은 지표도 조사 후보입니다. 작업 전후 시각을 기록합니다.

직접 실행하며 익혀보세요.

kubectl과 연결 가능한 개인 실습용 Kubernetes 클러스터가 필요합니다. 각 실습은 독립적이며, 먼저 현재 context를 확인하세요. 명령어는 자신의 터미널에서 실행합니다.

NODE_NAME을 실제 노드 이름으로 바꿔 조회하세요. 아래 호스트 명령은 systemd 기반 노드에 직접 접속한 터미널에서만 실행합니다.

kubectl get nodes
kubectl describe node NODE_NAME
# 다음 명령은 해당 노드의 터미널에서 실행
sudo systemctl status kubelet --no-pager
sudo journalctl -u kubelet --since "10 minutes ago" --no-pager
df -h

이렇게 확인하세요

Ready 조건과 최근 이벤트를 읽으세요. 관리형 노드에 접근할 수 없다면 호스트 명령은 건너뛰고 제공자의 노드 로그 기능을 확인합니다.

응용해보기

여러 Pod가 한 노드에서만 실패하고 DiskPressure=True입니다. 무엇을 수집하고 무엇을 피해야 할까요?

생각해본 뒤 풀이 보기

파일시스템과 inode 사용량, kubelet·런타임 로그, 영향받는 Pod와 이벤트 시각을 수집합니다. 런타임 데이터 디렉터리를 수동으로 삭제하지 않습니다. 원인을 확인한 뒤 보존 정책과 정식 정리 절차를 선택합니다.

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

노드가 NotReady일 때 첫 조사로 가장 적합한 것은?

  1. 즉시 모든 Pod 삭제
  2. Node conditions와 Events 확인
  3. 모든 Service 삭제
  4. 원인 확인 없이 인증서 교체
생각해본 뒤 풀이 보기

Node conditions와 Events 확인

먼저 상태와 이벤트로 증거를 수집합니다. 이후 kubelet·런타임·네트워크·자원 상태를 좁혀 조사합니다.

Kubernetes 공식 문서