study.

VPA를 Off 모드로 실행하고 권장 자원 읽기 · Kubernetes

자동 적용 전에 관측값·권장값·현재 요청을 구분해 판단합니다.

← Kubernetes

진도·퀴즈와 함께 학습하기

먼저, 개념을 잡아볼게요.

VPA는 별도 구성 요소

Vertical Pod Autoscaler는 기본 Kubernetes에 자동 설치되지 않습니다. CRD·recommender와 사용량 지표 공급이 필요하며 자동 적용 방식에는 updater·admission controller 등의 역할이 추가됩니다. CRD 존재만으로 추천이 생성된다고 보장하지 않습니다.

Off에서 권장값만 보기

updateMode=Off는 추천을 status에 기록하며 Pod 자원을 자동 변경하지 않습니다. target·lowerBound·upperBound는 추천과 범위를 나타내고 관측 시간·부하에 영향을 받습니다. 짧은 idle 실습값을 운영 최적값으로 사용하지 않습니다.

적용 정책과 중단 가능성

Initial은 생성 시 적용, Recreate는 교체를 통한 적용입니다. InPlaceOrRecreate 등의 지원과 재시작 가능성은 설치 VPA·Kubernetes 버전에 따라 확인합니다. 자동 적용은 PodDisruptionBudget·가용 용량·앱의 중단 허용과 함께 검토해야 합니다.

HPA와 함께 쓸 때

VPA는 자원 requests, HPA는 복제본 수를 조정합니다. CPU 사용률 기반 HPA는 requests를 기준으로 계산하므로 같은 자원을 VPA가 바꾸면 두 제어가 영향을 줍니다. Off에서 관측하거나 서로 다른 지표를 쓰는 등 조합을 설계해야 합니다.

왜 필요한가요?

VPA 추천은 관측한 사용량을 근거로 한 운영 판단 자료입니다. 조용한 실습 Pod의 몇 분짜리 기록은 피크 트래픽·배치 작업·메모리 누수 같은 운영 패턴을 대표하지 못합니다.

차례대로 이해하기

세 종류의 수치 비교

kubectl top은 현재 사용량, VPA status는 추천, Pod spec은 적용된 requests입니다. Off에서는 추천이 생성돼도 spec이 유지되는 것을 먼저 확인합니다. minAllowed·maxAllowed는 정책 범위이며 노드에 그 용량이 생긴다는 뜻은 아닙니다.

자동 적용 전 질문

어떤 컨테이너와 자원을 제어할지, Pod 교체나 resize를 허용할지, 중단 예산과 노드 용량이 있는지 확인합니다. HPA가 CPU 사용률을 기준으로 조정 중이라면 VPA의 requests 변경이 HPA 계산에 미칠 영향도 검토합니다.

직접 실행하며 익혀보세요.

kubectl과 개인 실습용 Kubernetes 클러스터, POSIX 셸이 필요합니다. cert-manager와 VPA 실습은 각 레슨에 명시한 사전 설치가 필요합니다. 노드 변경 실습은 폐기 가능한 전용 worker에서만 수행하며 전용 namespace를 사용합니다.

VPA CRD·recommender와 metrics-server 또는 지원되는 지표 공급이 준비된 개인 실습 클러스터가 필요합니다. VPA 공식 quickstart에서 설치 버전·구성을 확인하세요. 아래 코드는 자동 적용을 끄고 최소·최대 권장 범위를 지정합니다. 5분 내 추천이 없으면 무한히 기다리지 말고 VPA conditions·recommender 로그·metrics API를 확인하세요.

(
set -eu
kubectl config current-context
kubectl get crd verticalpodautoscalers.autoscaling.k8s.io
kubectl get --raw /apis/metrics.k8s.io/v1beta1/nodes >/dev/null
kubectl create namespace study-vpa --dry-run=client -o yaml | kubectl apply -f -
kubectl apply -n study-vpa -f - <<'YAML'
apiVersion: apps/v1
kind: Deployment
metadata:
  name: worker
spec:
  replicas: 1
  selector:
    matchLabels: {app: vpa-worker}
  template:
    metadata:
      labels: {app: vpa-worker}
    spec:
      containers:
      - name: worker
        image: busybox:1.36
        command: ["sh", "-c", "while true; do sleep 1; done"]
        resources:
          requests: {cpu: 50m, memory: 32Mi}
          limits: {cpu: 500m, memory: 256Mi}
---
apiVersion: autoscaling.k8s.io/v1
kind: VerticalPodAutoscaler
metadata:
  name: worker
spec:
  targetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: worker
  updatePolicy:
    updateMode: "Off"
  resourcePolicy:
    containerPolicies:
    - containerName: worker
      controlledResources: [cpu, memory]
      controlledValues: RequestsOnly
      minAllowed: {cpu: 25m, memory: 32Mi}
      maxAllowed: {cpu: 250m, memory: 128Mi}
YAML
kubectl rollout status deployment/worker -n study-vpa --timeout=120s
kubectl wait -n study-vpa --for=jsonpath='{.status.recommendation.containerRecommendations[0].target.cpu}' vpa/worker --timeout=300s
kubectl get vpa worker -n study-vpa -o yaml
kubectl top pods -n study-vpa
kubectl get pods -n study-vpa -l app=vpa-worker -o jsonpath='{range .items[*]}{.spec.containers[0].resources.requests}{"\n"}{end}'
kubectl get deployment worker -n study-vpa -o jsonpath='{.spec.template.spec.containers[0].resources.requests}{"\n"}'
)

이렇게 확인하세요

status.recommendation.containerRecommendations의 worker target과 lowerBound/upperBound를 읽습니다. 추천 숫자는 환경마다 다릅니다. Off이므로 실제 Pod와 Deployment의 requests는 50m/32Mi를 유지해야 합니다. metrics는 현재 관측, VPA status는 추천, spec은 현재 선언임을 구분하세요.

실습 리소스 정리

결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.

kubectl delete namespace study-vpa

응용해보기

추천 CPU가 200m인데 실제 Pod request가 계속 50m입니다. VPA 고장이라고 판단할 수 있나요?

생각해본 뒤 풀이 보기

먼저 updateMode를 봅니다. Off라면 의도한 정상 동작입니다. 추천을 자동 적용하려는 경우에는 지원되는 모드와 admission/updater 구성, 가용성·PDB·용량을 검토해야 하며 확인 없이 모드를 바꾸지 않습니다.

잠깐, 이해했는지 확인해볼까요?

VPA Off 모드에서 추천 CPU가 현재 requests보다 높아졌다면?

  1. 즉시 모든 Pod가 재시작된다
  2. 추천만 기록되고 자동 적용되지 않는다
  3. 노드 CPU가 자동 증설된다
  4. HPA가 반드시 비활성화된다
생각해본 뒤 풀이 보기

추천만 기록되고 자동 적용되지 않는다

Off에서는 추천을 분석할 수 있지만 자동 적용은 하지 않습니다. 조정 전 부하 대표성·제한 범위·노드 용량·HPA와의 상호작용을 검토합니다.

공식 문서 · VPA를 Off 모드로 실행하고 권장 자원 읽기 · VPA 설치 · 공식 quickstart