# EKS Containerd 트러블슈팅 가이드
## Containerd 역할
- 컨테이너 라이프사이클 관리
- 이미지 풀/저장
- 컨테이너 실행 (runc)
- Kubelet과 CRI 인터페이스로 통신
## 핵심 점검 포인트
### 1. Containerd 로그 분석
`containerd/containerd-log.txt` 주요 에러:
| 에러 메시지 | 원인 | 해결 |
|-------------|------|------|
| `failed to pull image` | 이미지 풀 실패 | ECR 권한, 네트워크 확인 |
| `failed to create shim` | 컨테이너 생성 실패 | 리소스, 런타임 확인 |
| `no space left on device` | 디스크 풀 | 이미지 정리, 디스크 확장 |
| `too many open files` | fd 제한 | ulimit 증가 |
### 2. 이미지 풀 문제
**ECR 인증 실패:**
```
failed to resolve reference: pull access denied
```
→ IAM 역할, IRSA 확인
**네트워크 문제:**
```
failed to do request: dial tcp: i/o timeout
```
→ VPC 엔드포인트, NAT Gateway 확인
### 3. Sandbox 생성 실패
```
RunPodSandbox: failed to create containerd container
```
**점검:**
1. containerd 로그
2. CNI 플러그인 (`var_log/aws-routed-eni/plugin.log`)
3. 네트워크 네임스페이스
## EKS Log Collector 파일 매핑
| 점검 항목 | 파일 위치 |
|-----------|-----------|
| Containerd 로그 | containerd/containerd-log.txt |
| Containerd 설정 | containerd/containerd-config.txt |
| 이미지 목록 | containerd/containerd-images.txt |
| 컨테이너 목록 | containerd/containerd-containers.txt |
