nerdctl로 실행·로그·삭제 연결하기 · containerd
Docker와 익숙한 명령 형태로 containerd를 사용합니다.
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
같은 모양, 다른 대상
nerdctl은 Docker와 비슷한 CLI를 제공하지만 Docker daemon이 아니라 containerd에 연결합니다. Docker에서 보던 객체가 그대로 나타난다고 가정하지 않습니다.
의존 기능
일반적인 bridge 네트워킹에는 CNI 플러그인이, 이미지 빌드에는 BuildKit 등 추가 구성이 필요할 수 있습니다. 이 실습은 빌드와 네트워크 통신 없이 --net none으로 진행합니다.
Namespace 일치
nerdctl과 ctr가 같은 소켓·namespace를 조회하는지 확인하면 두 도구의 목록을 연결해 읽을 수 있습니다. rootless와 rootful 저장소도 구분합니다.
왜 필요한가요?
익숙한 run·ps·logs 명령이 있어도 nerdctl은 Docker daemon을 대신 조작하는 도구가 아닙니다. 런타임과 부가 기능의 설치 범위를 함께 읽어야 합니다.
차례대로 이해하기
어디에 객체를 만들었는지 확인
실습 namespace를 명시하고 nerdctl과 ctr에서 같은 컨테이너 메타데이터를 비교합니다. rootless 실행과 sudo를 사용하는 rootful 실행은 같은 저장소라고 가정하지 않습니다.
기능별 의존성 분리
일반적인 네트워크 기능에는 CNI가, 이미지 빌드에는 BuildKit이 필요할 수 있습니다. 이 실습은 --net none으로 실행·로그 관찰에 집중하므로 성공해도 bridge 통신이나 빌드 준비까지 검증한 것은 아닙니다.
직접 실행하며 익혀보세요.
containerd·runc·ctr가 설치된 개인 Linux 실습 VM과 sudo 권한이 필요합니다. nerdctl 레슨은 nerdctl도, CRI 레슨은 crictl과 CRI가 활성화된 실습 노드도 필요합니다. 기본 소켓은 /run/containerd/containerd.sock으로 가정하며 다른 환경에서는 실제 주소를 확인하세요.
nerdctl이 설치된 실습 VM에서 네트워크 없는 BusyBox 컨테이너를 실행하고 로그와 종료 상태를 읽으세요. 명령이 없으면 공식 설치 안내를 먼저 따라야 합니다.
nerdctl --version
sudo nerdctl --namespace study-nerdctl run --net none --name study-nerd docker.io/library/busybox:1.36 echo nerdctl-ok
sudo nerdctl --namespace study-nerdctl ps -a
sudo nerdctl --namespace study-nerdctl logs study-nerd
sudo ctr --namespace study-nerdctl containers ls이렇게 확인하세요
로그에 nerdctl-ok가 있고 ps -a에 종료된 study-nerd가 보여야 합니다. ctr의 같은 namespace에서도 메타데이터를 확인합니다. CNI 오류가 나면 --net none 적용 여부와 도구 버전을 확인하세요.
실습 리소스 정리
결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.
sudo nerdctl --namespace study-nerdctl rm study-nerd
sudo ctr --namespace study-nerdctl images rm --sync docker.io/library/busybox:1.36
sudo ctr namespaces remove study-nerdctl응용해보기
--net none 실행은 되지만 기본 네트워크로 실행하면 CNI 오류가 납니다. 어떤 범위를 먼저 조사할까요?
생각해본 뒤 풀이 보기
네트워크 플러그인 바이너리와 설정, rootful/rootless 환경, 실제 오류를 확인합니다. 이미 프로세스 실행이 되는 상황이므로 이미지와 runtime 전체를 무조건 재설치하기보다 네트워크 의존성에 집중합니다.
잠깐, 이해했는지 확인해볼까요?
nerdctl이 기본적으로 연결하는 서버는?
- Docker daemon
- containerd
- etcd
- kube-apiserver
생각해본 뒤 풀이 보기
containerd
nerdctl은 containerd 클라이언트입니다. 명령이 Docker CLI와 비슷해도 Docker daemon을 사용한다는 뜻은 아닙니다.