# 1. Off 모드 — 추천만, 적용 안 함 (안전한 시작점)
apiVersion: autoscaling.k8s.io/v1
kind: VerticalPodAutoscaler
metadata:
  name: api-server-vpa
  namespace: production
spec:
  targetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: api-server
  updatePolicy:
    updateMode: "Off"      # 추천만 하고 파드 변경 안 함
  resourcePolicy:
    containerPolicies:
      - containerName: api
        minAllowed:
          cpu: 100m
          memory: 128Mi
        maxAllowed:
          cpu: 2000m
          memory: 4Gi
        controlledResources: ["cpu", "memory"]

# Off 모드 추천값 확인
kubectl describe vpa api-server-vpa -n production
# Recommendation:
#   Container Recommendations:
#     Container Name:  api
#     Lower Bound:
#       Cpu:     150m      ← 현재보다 낮추는 것이 가능한 하한
#       Memory:  256Mi
#     Target:
#       Cpu:     380m      ← VPA가 권장하는 최적값
#       Memory:  512Mi
#     Upper Bound:
#       Cpu:     800m      ← 피크 트래픽 대비 상한 추천
#       Memory:  1Gi
#     Uncapped Target:
#       Cpu:     380m      ← minAllowed/maxAllowed 제한 없이 계산한 값
#       Memory:  512Mi

# 2. Initial 모드 — 파드 시작 시에만 적용, 이후 변경 안 함
apiVersion: autoscaling.k8s.io/v1
kind: VerticalPodAutoscaler
metadata:
  name: batch-job-vpa
  namespace: production
spec:
  targetRef:
    apiVersion: batch/v1
    kind: Job
    name: etl-job
  updatePolicy:
    updateMode: "Initial"  # 파드 생성 시에만 requests 주입
  resourcePolicy:
    containerPolicies:
      - containerName: etl
        minAllowed:
          cpu: 500m
          memory: 1Gi
        maxAllowed:
          cpu: 8000m
          memory: 32Gi

# 3. Auto 모드 — 지속적으로 추천값 적용 (파드 재시작 포함)
apiVersion: autoscaling.k8s.io/v1
kind: VerticalPodAutoscaler
metadata:
  name: worker-vpa
  namespace: production
spec:
  targetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: background-worker
  updatePolicy:
    updateMode: "Auto"
    # 최소 업데이트 간격 설정 (기본값은 없음)
    minReplicas: 2         # 최소 2개 실행 중일 때만 Evict 허용
  resourcePolicy:
    containerPolicies:
      - containerName: worker
        minAllowed:
          cpu: 200m
          memory: 256Mi
        maxAllowed:
          cpu: 4000m
          memory: 8Gi
        # limits를 requests 대비 비율로 자동 설정
        controlledResources: ["cpu", "memory"]

HPA 선택 ← 수평 확장 가능한 서비스
┌─────────────────────────────────────┐
│ - 스테이트리스 API 서버              │
│ - 웹 프론트엔드                     │
│ - 메시지 컨슈머 (파티션 수만큼 확장) │
│ - 파드 수 늘릴 때 선형 처리량 증가  │
└─────────────────────────────────────┘

VPA 선택 ← 수직 확장이 필요한 서비스
┌─────────────────────────────────────┐
│ - 단일 레플리카 DB (Postgres, Redis) │
│ - 상태 저장 서비스 (Stateful Set)    │
│ - 배치 Job (더 큰 메모리로 빠르게)   │
│ - 사이드카 컨테이너 (리소스 추정 어려움) │
│ - 초기 requests/limits 설정 최적화  │
└─────────────────────────────────────┘

동시 사용 주의:
HPA는 CPU 사용률 기반으로 파드 수를 조정함
VPA는 requests를 올리면 CPU 사용률이 떨어짐
→ HPA가 파드를 줄이고 VPA가 requests를 올리는 사이클 발생 가능
→ 동시 사용 시: VPA에서 CPU 제어 비활성화하고 메모리만 제어

# HPA + VPA 동시 사용 시 — CPU는 HPA, 메모리는 VPA
apiVersion: autoscaling.k8s.io/v1
kind: VerticalPodAutoscaler
metadata:
  name: api-server-vpa-mem-only
spec:
  targetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: api-server
  updatePolicy:
    updateMode: "Auto"
  resourcePolicy:
    containerPolicies:
      - containerName: api
        # CPU는 VPA가 건드리지 않음 (HPA가 CPU 메트릭으로 파드 수 조정)
        controlledResources: ["memory"]
        minAllowed:
          memory: 256Mi
        maxAllowed:
          memory: 8Gi