🏗️ EKS 기반 사이트 HA 구성

사용자 → CloudFront → ALB → EKS Pods
                  → S3 (정적 콘텐츠)

정적 콘텐츠: 사용자 → WAF → CloudFront → S3
동적 API: 사용자 → WAF → CloudFront → VPC → ALB → EKS Pods

🌐 VPC 외부: S3, CloudFront, WAF
🏠 VPC 내부: ALB (Multi-AZ), NAT Gateway, EKS (HA 구성)

📱 FastAPI (웹 서버)     → Deployment (Stateless)
   "요청 처리만 하고 끝, 메모리에 저장 안 함"

💾 PostgreSQL (데이터베이스) → StatefulSet (Stateful)  
   "데이터 파일 저장, 순서대로 시작/종료 필요"

🗄️ Redis (캐시)         → StatefulSet (Stateful)
   "메모리 데이터 보존 필요"

infrastructure/k8s/
├── namespace.yaml
├── postgres-deployment.yaml    # ❌ Deployment, replicas: 1
└── backend-deployment.yaml     # ❌ 분산 정책 없음

infrastructure/k8s/
├── namespace.yaml                    # 네임스페이스 분리
├── postgres-deployment.yaml         # ✅ StatefulSet + Anti-Affinity
├── redis-statefulset.yaml           # ✅ 새로 생성 (HA 구성)
├── backend-deployment.yaml          # ✅ Topology Spread 추가
├── backend-service.yaml             # LoadBalancer Service
└── ingress.yaml                     # ✅ 새로 생성 (ALB Ingress)

kind: Deployment          # ❌ Stateless
spec:
  replicas: 1             # ❌ 단일 인스턴스
  template:
    spec:
      # ❌ Anti-Affinity 없음
      containers:
      - name: postgres
        # ❌ 영구 스토리지 없음

apiVersion: apps/v1
kind: StatefulSet         # ✅ Stateful - 상태를 기억하는 Pod 집합
metadata:
  name: postgres
spec:
  serviceName: postgres   # ✅ StatefulSet 필수 - 안정적인 네트워크 ID
  replicas: 2             # ✅ HA 구성 - 2개 인스턴스로 가용성 확보
  template:
    spec:
      affinity:           # ✅ Anti-Affinity 추가
        podAntiAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:  # 엄격한 규칙
          - labelSelector:
              matchExpressions:
              - key: app
                operator: In
                values:
                - postgres
            topologyKey: topology.kubernetes.io/zone  # AZ 단위로 분산
      containers:
      - name: postgres
        image: postgres:15
        volumeMounts:     # ✅ 영구 스토리지 - 데이터 보존
        - name: postgres-storage
          mountPath: /var/lib/postgresql/data  # PostgreSQL 데이터 디렉토리
  volumeClaimTemplates:   # ✅ 각 Pod마다 독립 스토리지
  - metadata:
      name: postgres-storage
    spec:
      accessModes: ["ReadWriteOnce"]  # 하나의 노드에서만 읽기/쓰기
      resources:
        requests:
          storage: 10Gi   # 10GB 영구 스토리지 할당

퍼블릭 서브넷: ALB, NAT Gateway
프라이빗 서브넷: EKS 워커 노드, 애플리케이션

ALB SG: 80, 443 포트만 인터넷에서 허용
Worker SG: ALB에서만 트래픽 허용

# ALB 헬스체크 확인
kubectl get ingress
kubectl describe ingress edustack-ingress

# Pod 간 통신 테스트
kubectl exec -it fastapi-pod -- curl postgres:5432
kubectl exec -it fastapi-pod -- redis-cli -h redis ping

# 서비스 DNS 해상도 테스트
kubectl exec -it fastapi-pod -- nslookup postgres
kubectl exec -it fastapi-pod -- nslookup redis

# 현재 Pod 분산 상태 확인
kubectl get pods -o wide --show-labels

# 하나의 AZ 장애 시뮬레이션
kubectl cordon node-in-az-2a  # 노드 스케줄링 중단
kubectl delete pod postgres-0  # Pod 강제 삭제

# 복구 과정 관찰
kubectl get pods -o wide -w  # 실시간 상태 변화 관찰
kubectl logs postgres-1      # 남은 Pod 로그 확인

# 복구 후 정리
kubectl uncordon node-in-az-2a  # 노드 스케줄링 재개

# 트래픽 분산 확인
for i in {1..10}; do
  curl -s https://your-domain.com/api/edustack/health | jq .hostname
done

# ALB 타겟 그룹 상태 확인
aws elbv2 describe-target-health \
  --target-group-arn arn:aws:elasticloadbalancing:... \
  --profile shared-service

# Pod 리소스 사용량 모니터링
kubectl top pods
kubectl top nodes

# CloudWatch 메트릭 확인
aws cloudwatch get-metric-statistics \
  --namespace AWS/ApplicationELB \
  --metric-name RequestCount \
  --dimensions Name=LoadBalancer,Value=app/edustack-alb/... \
  --start-time 2025-10-04T00:00:00Z \
  --end-time 2025-10-04T23:59:59Z \
  --period 3600 \
  --statistics Sum

# Kubernetes 메트릭
kubectl top pods --sort-by=cpu
kubectl top pods --sort-by=memory

# HPA 설정 (Auto Scaling)
kubectl autoscale deployment edustack-backend \
  --cpu-percent=70 --min=2 --max=10