다음을 통해 공유


Vertical Pod Autoscaler API 참조

이 문서에서는 Azure Kubernetes Service의 Vertical Pod Autoscaler 기능에 대한 API 참조를 제공합니다.

이 참조는 VPA의 AKS 구현 버전 0.13.0을 기반으로 합니다.

VerticalPodAutoscaler

이름 Object 설명
metadata ObjectMeta 표준 개체 메타데이터
spec VerticalPodAutoscalerSpec Vertical Pod Autoscaler의 원하는 동작
status VerticalPodAutoscalerStatus 가장 최근에 관찰된 Vertical Pod Autoscaler 상태

VerticalPodAutoscalerSpec

이름 Object 설명
targetRef CrossVersionObjectReference 제어할 자동 크기 조정기의 Pod 집합을 관리하는 컨트롤러에 대한 참조입니다. 예를 들면 배포나 StatefulSet입니다. Scale 하위 리소스가 있는 모든 컨트롤러에서 Vertical Pod Autoscaler를 가리킬 수 있습니다. 일반적으로 Vertical Pod Autoscaler는 컨트롤러의 ScaleStatus에서 Pod 집합을 검색합니다.
updatePolicy PodUpdatePolicy Pod가 시작될 때 권장 업데이트가 적용되는지 여부와 Pod 수명 동안 권장 업데이트가 적용되는지 여부를 지정합니다.
resourcePolicy PodResourcePolicy 개별 컨테이너에서 CPU 및 메모리 요청이 조정되는 방법에 대한 정책을 지정합니다. 리소스 정책을 사용하여 개별 컨테이너 권장 사항에 대한 제약 조건을 설정할 수 있습니다. 지정하지 않으면 자동 크기 조정기는 추가 제약 조건 없이 Pod의 모든 컨테이너에 대한 권장 리소스를 계산합니다.
recommenders VerticalPodAutoscalerRecommenderSelector 추천자가 VPA 개체에 대한 권장 사항을 생성해야 합니다. 기본 추천자를 사용하려면 비워 둡니다. 그렇지 않으면 목록에 사용자가 제공한 대체 추천자 항목이 정확히 하나 포함될 수 있습니다.

VerticalPodAutoscalerList

이름 Object 설명
metadata ObjectMeta 표준 개체 메타데이터
항목 VerticalPodAutoscaler(배열) Vertical Pod Autoscaler 개체 목록입니다.

PodUpdatePolicy

이름 Object 설명
updateMode string Pod가 시작될 때 권장 업데이트가 적용되는지 여부와 Pod 수명 동안 권장 업데이트가 적용되는지 여부를 지정하는 문자열입니다. 가능한 값은 Off, Initial, RecreateAuto입니다. 값을 지정하지 않으면 기본값은 Auto입니다.
minReplicas int32 Pod 제거를 시도하기 위해 Updater가 활성 상태여야 하는 최소 복제본 수를 나타내는 값입니다(Pod 중단 예산과 같은 다른 검사 보류 중). 양의 값만 허용됩니다. 기본값은 2로 설정된 전역 --min-replicas 플래그입니다.

PodResourcePolicy

이름 Object 설명
conainerPolicies ContainerResourcePolicy 개별 컨테이너의 리소스 정책 배열입니다. 명명된 모든 컨테이너의 항목이 최대 하나 있을 수 있으며 선택적으로 개별 정책이 없는 모든 컨테이너를 처리하는 containerName = '*'가 포함된 단일 와일드카드 항목이 있을 수 있습니다.

ContainerResourcePolicy

이름 Object 설명
containerName string 정책이 적용되는 컨테이너의 이름을 지정하는 문자열입니다. 지정하지 않으면 정책은 기본 정책으로 제공됩니다.
mode ContainerScalingMode 컨테이너가 시작될 때 권장 업데이트가 컨테이너에 적용되는지 여부와 컨테이너 수명 동안 권장 업데이트가 적용되는지 여부를 지정합니다. 가능한 값은 OffAuto입니다. 값을 지정하지 않으면 기본값은 Auto입니다.
minAllowed ResourceList 컨테이너에 허용되는 최소 CPU 요청 및 메모리 요청을 지정합니다. 기본적으로 최솟값은 적용되지 않습니다.
maxAllowed ResourceList 컨테이너에 허용되는 최대 CPU 요청 및 메모리 요청을 지정합니다. 기본적으로 최댓값은 적용되지 않습니다.
ControlledResources []ResourceName Vertical Pod Autoscaler에서 계산(및 적용 가능)하는 권장 사항 형식을 지정합니다. 비어 있으면 [ResourceCPU, ResourceMemory]의 기본값이 사용됩니다.

VerticalPodAutoscalerRecommenderSelector

이름 Object 설명
이름 string 이 개체의 권장 사항을 생성해야 하는 추천자의 이름을 지정하는 문자열입니다.

VerticalPodAutoscalerStatus

이름 Object 설명
권장 사항 RecommendedPodResources 가장 최근에 권장되는 CPU 및 메모리 요청입니다.
조건 VerticalPodAutoscalerCondition Vertical Pod Autoscaler의 현재 상태를 설명하는 배열입니다.

RecommendedPodResources

이름 Object 설명
containerRecommendation RecommendedContainerResources 개별 컨테이너의 리소스 권장 사항 배열입니다.

RecommendedContainerResources

이름 Object 설명
containerName string 권장 사항이 적용되는 컨테이너의 이름을 지정하는 문자열입니다.
target ResourceList 컨테이너의 권장 CPU 요청 및 메모리 요청입니다.
lowerBound ResourceList 컨테이너의 최소 권장 CPU 요청 및 메모리 요청입니다. 이 양은 애플리케이션이 안정적으로 되기에 충분하다고 보장되지 않습니다. 더 작은 CPU 및 메모리 요청을 실행하면 성능이나 가용성이 큰 영향을 받을 가능성이 있습니다.
upperBound ResourceList 컨테이너의 최대 권장 CPU 요청 및 메모리 요청입니다. 이러한 값보다 높은 CPU 및 메모리 요청은 낭비될 가능성이 있습니다.
uncappedTarget ResourceList 컨테이너 리소스 정책을 고려하지 않고 실제 리소스 사용량을 기준으로 자동 크기 조정기에서 계산한 최신 리소스 권장 사항입니다. 실제 리소스 사용량으로 인해 대상이 컨테이너 리소스 정책을 위반하는 경우 제한된 권장 사항과 다를 수 있습니다. 이 필드는 실제 자원 할당에 영향을 미치지 않습니다. 상태 표시로만 사용됩니다.

VerticalPodAutoscalerCondition

이름 Object 설명
type VerticalPodAutoscalerConditionType 설명되는 조건의 형식입니다. 가능한 값은 RecommendationProvided, LowConfidence, NoPodsMatchedFetchingHistory입니다.
status ConditionStatus 조건 상태입니다. 가능한 값은 True, FalseUnknown 입니다.
lastTransitionTime Time 조건이 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다.
reason string 마지막으로 한 상태에서 다른 상태로 전환된 이유입니다.
message string 한 상태에서 다른 상태로의 마지막 전환에 대한 세부 정보를 제공하는 사람이 읽을 수 있는 문자열입니다.

다음 단계

클러스터 리소스 사용률을 개선하고 다른 Pod를 위해 CPU 및 메모리를 확보하는 방법은 Vertical Pod Autoscaler를 참조하세요.