study.

플러그인·디스크·로그로 런타임 진단하기 · containerd

재시작을 먼저 하기보다 런타임과 호스트의 증거를 모읍니다.

← containerd

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

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

플러그인 상태

plugins ls는 로드된 기능과 상태를 보여줍니다. 모든 선택적 플러그인이 활성화돼야 하는 것은 아니므로 실제 사용하는 snapshotter·CRI와 관련된 항목을 찾습니다.

콘텐츠와 snapshot

이미지 콘텐츠 저장과 실행용 파일시스템 snapshot은 역할이 다릅니다. 이미지 목록이 있다고 snapshot 준비나 태스크 실행까지 항상 성공한 것은 아닙니다.

호스트 자원과 로그

디스크 블록뿐 아니라 inode 부족도 쓰기 실패를 만들 수 있습니다. systemd 로그의 같은 시각 오류를 함께 읽고 원인 없이 서비스 재시작이나 데이터 디렉터리 삭제를 하지 않습니다.

왜 필요한가요?

“디스크가 찼다”는 현상에는 이미지 콘텐츠, snapshot, 로그 등 여러 사용처가 있습니다. 어떤 자원이 차지하는지 확인하지 않고 런타임 내부 디렉터리를 지우면 참조와 실제 파일이 어긋날 수 있습니다.

차례대로 이해하기

기능 상태와 호스트 상태

plugins ls에서 필요한 플러그인이 정상인지 확인하고 데몬 로그의 오류 시각을 맞춥니다. df -h와 df -i로 바이트와 inode를 나눠 확인합니다. 플러그인 하나의 오류를 모든 기능의 실패로 확대 해석하지 않습니다.

참조와 회수 이해

이미지·컨테이너·snapshot은 참조 관계를 가집니다. 참조나 lease가 남아 있으면 콘텐츠가 회수되지 않을 수 있고 삭제 직후 공간이 즉시 줄지 않을 수도 있습니다. 지원되는 CLI로 실습 자원만 정리합니다.

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

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

systemd 기반 개인 실습 VM에서 읽기 전용 진단 명령을 실행하세요. unit 이름이 다르거나 systemd가 없는 환경에서는 제공자의 로그 수집 방법을 사용합니다.

sudo ctr plugins ls
sudo ctr --namespace k8s.io images ls
sudo ctr --namespace k8s.io snapshots ls
df -h
df -i
sudo systemctl status containerd --no-pager
sudo journalctl -u containerd --since '10 minutes ago' --no-pager -n 30

이렇게 확인하세요

사용 중인 snapshotter의 상태, 디스크·inode 여유, 최근 오류 유무를 각각 기록하세요. 오류가 없는 경우 정상이라는 관찰을 남기면 됩니다. 설정 기본값을 덮어쓰는 명령이나 전역 prune은 실행하지 않습니다.

응용해보기

이미지 하나를 지웠지만 여유 공간이 거의 늘지 않았습니다. 바로 파일을 수동 삭제해야 할까요?

생각해본 뒤 풀이 보기

아닙니다. 공유 레이어, 남은 컨테이너·snapshot·lease 참조, GC 진행 여부, 로그 등 다른 사용처를 조사합니다. 운영 데이터 디렉터리에 rm을 실행하는 것으로 회수 절차를 대신하지 않습니다.

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

디스크 용량이 남는데 파일 생성이 실패할 때 추가 확인할 것은?

  1. inode 사용량과 파일시스템 오류
  2. 컨테이너 이름 길이만
  3. 이미지 태그의 대소문자만
  4. Service의 DNS 이름
생각해본 뒤 풀이 보기

inode 사용량과 파일시스템 오류

inode 부족이나 파일시스템 문제도 쓰기 실패를 일으킬 수 있습니다. df -h와 df -i, 로그를 함께 확인해야 합니다.

공식 문서 · 플러그인·디스크·로그로 런타임 진단하기 · 심화 참고 · 공식 문서