crictl로 Pod Sandbox와 컨테이너 구분하기 · containerd
Kubernetes 노드에서 kubelet이 보는 런타임 관점으로 조사합니다.
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
CRI API
kubelet은 CRI를 통해 런타임에 요청합니다. ctr가 연결된다고 해서 CRI 플러그인까지 정상이라는 뜻은 아니므로 별도 확인이 필요합니다.
Sandbox와 컨테이너
crictl pods는 Pod sandbox를, ps는 컨테이너를 보여줍니다. Kubernetes API의 Pod 상태와 런타임의 관찰 결과를 연결하되 같은 객체라고 단정하지 않습니다.
명시적 endpoint
소켓 자동 추측보다 실제 runtime endpoint를 지정하세요. 노드 배포판에 따라 경로가 다를 수 있으며 관리형 환경에서는 호스트 접근이 제한될 수 있습니다.
왜 필요한가요?
Kubernetes의 Pod와 CRI의 Pod Sandbox를 구분하면 같은 Pod 안에서 컨테이너가 재시작되는 상황을 읽을 수 있습니다. Sandbox는 네트워크 같은 실행 환경의 맥락을 제공합니다.
차례대로 이해하기
목록의 단위 구분
crictl pods는 sandbox를, ps는 컨테이너를 조회합니다. ps -a로 종료된 인스턴스도 확인하고 Pod 이름만이 아니라 ID와 attempt 등 관찰값을 연결해 봅니다.
Kubernetes 관찰과 대조
kubectl에서 본 Pod의 노드·namespace와 해당 노드의 CRI 목록을 맞춥니다. Kubernetes metadata는 CRI label 등에 나타날 수 있지만 ctr의 namespace가 Kubernetes namespace와 같은 것은 아닙니다.
직접 실행하며 익혀보세요.
containerd·runc·ctr가 설치된 개인 Linux 실습 VM과 sudo 권한이 필요합니다. nerdctl 레슨은 nerdctl도, CRI 레슨은 crictl과 CRI가 활성화된 실습 노드도 필요합니다. 기본 소켓은 /run/containerd/containerd.sock으로 가정하며 다른 환경에서는 실제 주소를 확인하세요.
CRI가 활성화된 개인 Kubernetes 노드에서만 실행하세요. 기본 containerd 소켓을 가정한 읽기 전용 명령입니다. 일반 containerd VM에서 CRI 미설정 오류가 나는 것은 그 자체로 고장이 아닙니다.
sudo crictl --runtime-endpoint unix:///run/containerd/containerd.sock info
sudo crictl --runtime-endpoint unix:///run/containerd/containerd.sock pods
sudo crictl --runtime-endpoint unix:///run/containerd/containerd.sock ps -a
sudo ctr --namespace k8s.io containers ls이렇게 확인하세요
info의 RuntimeReady와 NetworkReady 조건을 구분하고 pods와 ps -a의 목록 차이를 설명하세요. CRI unavailable이면 endpoint·플러그인 활성화·버전 호환성을 조사합니다. 운영 Pod를 rm·stop으로 직접 변경하지 않습니다.
응용해보기
Pod 이름은 같은데 종료된 컨테이너 ID와 새 실행 ID가 함께 보입니다. 무엇을 확인할까요?
생각해본 뒤 풀이 보기
같은 sandbox·Pod에 속하는지, 컨테이너 이름과 재시도 번호, 종료 사유를 확인합니다. 재시작으로 생성된 새 인스턴스인지 구분하고 조사를 위해 Kubernetes 관리 컨테이너를 직접 삭제하지 않습니다.
잠깐, 이해했는지 확인해볼까요?
crictl pods가 나열하는 대상은?
- Docker 이미지 태그
- Pod sandbox
- 모든 Kubernetes Service
- Git 브랜치
생각해본 뒤 풀이 보기
Pod sandbox
crictl pods는 런타임의 Pod sandbox를 조회하고 crictl ps는 컨테이너를 조회합니다.