kubectl apply → API Server → ETCD → Scheduler → Kubelet → Running
  0.1초        0.1초       0.5초     0.1초      5-30초

가장 오래 걸리는 단계: 이미지 다운로드 (5-30초)
전체 소요 시간: 7-35초 (이미지 크기에 따라)

kubectl get pods --watch
NAME    READY   STATUS              AGE
nginx   0/1     ContainerCreating   30s  # ← 왜 이렇게 오래 걸려?

kubectl apply -f pod.yaml
    ↓ (1) 0.1초
┌─────────────────────────────────────┐
│  API Server                          │
│  - 인증/인가 확인                    │
│  - YAML 검증                         │
└──────────────┬──────────────────────┘
               ↓ (2) 0.05초
┌─────────────────────────────────────┐
│  ETCD                                │
│  - Pod 정보 저장                     │
│  - status: "Pending"                 │
└──────────────┬──────────────────────┘
               ↓ (3) 0.5-2초
┌─────────────────────────────────────┐
│  Scheduler                           │
│  - 적합한 노드 찾기                  │
│  - nodeName 결정                     │
└──────────────┬──────────────────────┘
               ↓ (4) 0.1초
┌─────────────────────────────────────┐
│  Kubelet (워커 노드)                 │
│  - 이미지 다운로드 ⭐ (가장 오래!)   │
│  - 컨테이너 생성                     │
└──────────────┬──────────────────────┘
               ↓ (5) 5-30초
        Pod Running ✅

# ~/.kube/config 파일에서 클러스터 정보 읽기
cat ~/.kube/config

clusters:
- cluster:
    server: https://192.168.1.100:6443  # ← API Server 주소

# time 명령으로 측정
time kubectl apply -f simple-pod.yaml

# 출력:
real    0m0.152s  # ← API Server 응답 시간

Key: /registry/pods/default/nginx
Value: {
  "metadata": {
    "name": "nginx",
    "namespace": "default"
  },
  "spec": {
    "containers": [...]
  },
  "status": {
    "phase": "Pending"  # ← 초기 상태
  }
}

ETCDCTL_API=3 etcdctl get /registry/pods/default/nginx \
  --endpoints=https://127.0.0.1:2379 \
  --cacert=/etc/kubernetes/pki/etcd/ca.crt \
  --cert=/etc/kubernetes/pki/etcd/server.crt \
  --key=/etc/kubernetes/pki/etcd/server.key

모든 노드 검사:
├─ CPU 부족 노드 제외
├─ Memory 부족 노드 제외
├─ NodeSelector 불일치 제외
├─ Taint/Toleration 불일치 제외
└─ 결과: 가능한 노드 리스트

각 노드에 점수 부여:
├─ 리소스 여유도 (가중치 1)
├─ Pod 분산도 (가중치 1)
├─ Affinity 규칙 (가중치 2)
└─ 결과: 최고 점수 노드 선택

초기 상태:
- node1: CPU 90%, Memory 80%
- node2: CPU 50%, Memory 60%  ← 점수 높음!
- node3: CPU 70%, Memory 85%

Scheduler 결정: node2 선택 ✅

# Scheduler 결정 시간 확인
kubectl get events --sort-by='.lastTimestamp' | grep Scheduled

# 출력:
0s   Normal  Scheduled  pod/nginx  Successfully assigned default/nginx to node2

# 왜 이 노드에 배정됐는지 확인
kubectl describe pod nginx

# Events 섹션:
Events:
  Type    Reason     Message
  ----    ------     -------
  Normal  Scheduled  Successfully assigned to node2

Kubelet (node2):
"어? ETCD에 내 노드 이름이 추가됐네!"
"이 Pod를 실행해야겠다!"

docker images nginx
REPOSITORY   TAG      SIZE
nginx        latest   187MB  # ← 약 6초 소요 (내 환경)

1. 로컬에 이미지 있나? 확인 (0.1초)
   └─ 있으면 → 즉시 컨테이너 생성 (1-2초)
   └─ 없으면 → 다운로드 시작

2. Docker Hub에서 다운로드
   nginx:latest (187MB)
   ├─ Layer 1: 50MB (2초)
   ├─ Layer 2: 37MB (1초)
   └─ Layer 3: 100MB (3초)
   합계: 6초

3. 압축 해제 & 검증 (1초)

4. 컨테이너 생성 (1초)

# 로컬에 이미지 없는 상태로 테스트
docker rmi nginx:latest

# Pod 생성 시간 측정
kubectl delete pod nginx
time kubectl apply -f nginx-pod.yaml && \
  kubectl wait --for=condition=ready pod/nginx --timeout=60s

# 출력:
real    0m8.234s  # ← 8초 소요 (이미지 다운 포함)

# 이미지 있는 상태로 재시도
kubectl delete pod nginx
time kubectl apply -f nginx-pod.yaml && \
  kubectl wait --for=condition=ready pod/nginx --timeout=60s

# 출력:
real    0m2.145s  # ← 2초! (이미지 캐시 사용)

Container Runtime (containerd):
1. 컨테이너 생성 (0.5초)
   └─ 네임스페이스, Cgroup 설정
   
2. 네트워크 설정 (0.3초)
   └─ CNI 플러그인 호출
   └─ IP 할당 (예: 10.244.1.5)
   
3. 볼륨 마운트 (0.2초)
   └─ ConfigMap, Secret 등
   
4. ENTRYPOINT 실행 (0.1초)
   └─ nginx 프로세스 시작

ETCD 업데이트:
{
  "status": {
    "phase": "Running",  # ← Pending에서 변경!
    "containerStatuses": [{
      "ready": true,
      "restartCount": 0,
      "state": {
        "running": {
          "startedAt": "2025-10-13T10:05:30Z"
        }
      }
    }]
  }
}

# 터미널 1: Pod 상태 실시간 보기
kubectl get pods --watch

# 터미널 2: 이벤트 실시간 보기 (가장 중요!)
kubectl get events --watch

# 터미널 3: Pod 생성
kubectl apply -f nginx-pod.yaml

NAME    READY   STATUS    AGE
nginx   0/1     Pending   0s
nginx   0/1     Pending   0s      # ← Scheduler 작동 전
nginx   0/1     ContainerCreating  2s  # ← 노드 배정됨
nginx   1/1     Running   8s      # ← 완료!

LAST SEEN   TYPE    REASON      MESSAGE
0s          Normal  Scheduled   Successfully assigned default/nginx to node1
2s          Normal  Pulling     Pulling image "nginx:latest"
7s          Normal  Pulled      Successfully pulled image
8s          Normal  Created     Created container nginx
8s          Normal  Started     Started container nginx

kubectl get events --sort-by='.lastTimestamp' | tail -20

spec:
  containers:
  - name: nginx
    image: nginx:latest
    # imagePullPolicy 없음 → Always로 동작

spec:
  containers:
  - name: nginx
    image: nginx:latest
    imagePullPolicy: IfNotPresent  # 로컬 우선!

nginx:latest  # 187MB → 6초

nginx:alpine  # 42MB → 2초  ⭐

# nginx:latest 테스트
time kubectl apply -f nginx-pod.yaml && \
  kubectl wait --for=condition=ready pod/nginx --timeout=60s
# real    0m8.234s

# nginx:alpine 테스트
time kubectl apply -f nginx-alpine-pod.yaml && \
  kubectl wait --for=condition=ready pod/nginx-alpine --timeout=60s
# real    0m4.156s

# 뭔가 이상하면 무조건 이것부터!
kubectl get events --sort-by='.lastTimestamp'

kubectl describe pod my-app

# Events:
Events:
  Type    Reason     Message
  Normal  Scheduled  Successfully assigned to node1
  Normal  Pulling    Pulling image...
  Warning Failed     Failed to pull image: timeout  # ← 원인!

1. kubectl get pods  # 상태 확인
2. kubectl describe pod <name>  # Events 확인
3. kubectl logs <name>  # 앱 로그 확인