study.

containerd·runc·클라이언트 구분하기 · containerd

같은 컨테이너를 다뤄도 도구마다 사용하는 API와 역할이 다릅니다.

← containerd

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

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

역할 분리

containerd는 이미지와 컨테이너 수명 등을 관리하고 OCI runtime인 runc는 실제 프로세스 실행에 관여합니다. shim은 실행 중인 태스크와 데몬 사이를 중재합니다.

도구 선택

ctr는 containerd의 저수준 진단 도구입니다. nerdctl은 Docker와 비슷한 사용 경험을 제공하며 crictl은 Kubernetes CRI API를 통해 관찰합니다.

버전과 설정

containerd 1.x와 2.x는 설정 버전과 플러그인 이름이 다를 수 있습니다. config default는 설치된 바이너리의 기본 예제를 출력할 뿐 현재 실행 중인 설정을 증명하지 않습니다.

왜 필요한가요?

Docker CLI·nerdctl·ctr·crictl이 모두 컨테이너를 다룬다고 해서 같은 API와 같은 객체 목록을 사용하는 것은 아닙니다. 어떤 소켓에 어떤 API로 연결하는지가 출발점입니다.

차례대로 이해하기

역할 연결

containerd는 수명과 저장 자원을 관리하고 runc는 OCI 설정에 따라 프로세스 실행을 담당합니다. shim은 실행 중인 task와 데몬 사이에 존재합니다. 클라이언트는 이 구성 요소와 같은 역할이 아닙니다.

조회 위치 고정

버전과 소켓을 먼저 기록합니다. ctr는 containerd API, crictl은 CRI를 사용하며 nerdctl은 Docker와 유사한 사용자 경험을 제공합니다. 하나의 도구에서 비어 있다고 다른 도구의 객체도 없다고 추론하지 않습니다.

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

containerd·runc·ctr가 설치된 개인 Linux 실습 VM과 sudo 권한이 필요합니다. nerdctl 레슨은 nerdctl도, CRI 레슨은 crictl과 CRI가 활성화된 실습 노드도 필요합니다. 기본 소켓은 /run/containerd/containerd.sock으로 가정하며 다른 환경에서는 실제 주소를 확인하세요.

버전과 플러그인을 읽고 기본 설정의 앞부분을 출력하세요. 설정 파일을 덮어쓰거나 데몬을 재시작하지 않습니다. rootless 환경은 이 명령의 소켓·권한 가정과 다릅니다.

containerd --version
runc --version
sudo ctr version
sudo ctr plugins ls
containerd config default | sed -n "1,35p"

이렇게 확인하세요

ctr version의 Client와 Server를 구분하고 plugins ls에서 상태를 읽으세요. 소켓 연결 실패 시 파일 존재·권한·주소를 확인합니다. config default 출력을 실제 적용 설정이라고 기록하지 마세요.

응용해보기

ctr 목록은 보이는데 crictl 연결은 실패합니다. containerd 전체가 죽었다고 할 수 있을까요?

생각해본 뒤 풀이 보기

그렇지 않습니다. CRI endpoint·플러그인 활성화·권한을 별도로 확인합니다. containerd API가 응답하는 사실과 CRI API가 사용 가능한 사실은 구분해야 합니다.

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

Kubernetes CRI API를 통해 컨테이너를 진단하는 도구는?

  1. Dockerfile
  2. crictl
  3. kubectl kustomize
  4. git
생각해본 뒤 풀이 보기

crictl

crictl은 CRI를 사용합니다. ctr와 nerdctl은 containerd 네이티브 API를 사용하므로 관찰 범위와 객체 모델이 다릅니다.

공식 문서 · containerd·runc·클라이언트 구분하기