Hands-on

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
spec:
  replicas: 6
  selector:
    matchLabels: { app: web }
  template:
    metadata:
      labels: { app: web }
    spec:
      topologySpreadConstraints:
        - maxSkew: 1
          topologyKey: topology.kubernetes.io/zone
          whenUnsatisfiable: DoNotSchedule
          labelSelector:
            matchLabels: { app: web }
      affinity:
        podAntiAffinity:
          preferredDuringSchedulingIgnoredDuringExecution:
            - weight: 100
              podAffinityTerm:
                labelSelector:
                  matchLabels: { app: web }
                topologyKey: kubernetes.io/hostname
      containers:
        - name: web
          image: nginx
          resources:
            requests: { cpu: "100m", memory: "128Mi" }
            limits: { cpu: "200m", memory: "128Mi" }

kubectl autoscale deployment web --cpu-percent=70 --min=3 --max=10

# 또는 YAML로 (커스텀 메트릭 포함 시 더 명확)
cat <<EOF | kubectl apply -f -
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: web
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: web
  minReplicas: 3
  maxReplicas: 10
  metrics:
    - type: Resource
      resource:
        name: cpu
        target:
          type: Utilization
          averageUtilization: 70
EOF

kubectl get hpa web --watch

# 1) 스케줄러가 왜 못 배치했는지 이벤트 확인 — 가장 먼저 볼 것
kubectl describe pod <pod-name> | grep -A10 Events

# 흔한 메시지와 원인:
# "Insufficient cpu/memory"        → 노드 리소스 부족, requests 재검토 or 노드 추가
# "node(s) had taint ... not tolerated" → toleration 누락
# "didn't match Pod's node affinity"    → nodeAffinity 조건 확인
# "0/N nodes are available: N node(s) had volume node affinity conflict" → PVC가 다른 zone에 묶여있음

# 2) 클러스터 전체 가용 리소스 확인
kubectl describe nodes | grep -A5 "Allocated resources"

# 3) Cluster Autoscaler/Karpenter 로그 확인 (노드가 늘어나야 하는데 안 늘어나는 경우)
kubectl logs -n kube-system -l app=cluster-autoscaler --tail=50

# 1) 직전 컨테이너의 종료 코드와 마지막 로그 확인
kubectl describe pod <pod-name> | grep -A5 "Last State"
kubectl logs <pod-name> --previous

# 종료 코드 해석:
# Exit Code 0   → 정상 종료인데 재시작됨 (livenessProbe 설정 또는 restartPolicy 확인)
# Exit Code 1   → 애플리케이션 에러 (로그 확인)
# Exit Code 137 → OOMKilled (메모리 limit 부족, kubectl describe pod 에서 "OOMKilled" 확인)
# Exit Code 143 → SIGTERM (정상 종료 신호, graceful shutdown 시간 부족 가능성)

# 2) 메모리 문제인지 빠르게 확인
kubectl describe pod <pod-name> | grep -i oom
kubectl top pod <pod-name>  # metrics-server 필요