4장. HorizontalPodAutoscaler [autoscaling/v2]

동작

object

HorizontalPodAutoscalerBehavior는 각각 Up 및 Down 방향(scaleUp 및 scaleDown 필드)에서 대상의 스케일링 동작을 구성합니다.

maxReplicas

integer

maxReplicas는 자동 스케일러가 확장할 수 있는 복제본 수의 상한입니다. minReplicas보다 작을 수 없습니다.

metrics

array

메트릭에는 원하는 복제본 수를 계산하는 데 사용할 사양이 포함되어 있습니다(모든 메트릭의 최대 복제본 수가 사용됩니다). 원하는 복제본 수는 대상 값과 현재 값 간의 비율을 현재 Pod 수를 곱한 값입니다. ergo, Pod 수가 증가하면 사용되는 메트릭이 감소해야 하며 그 반대의 경우도 마찬가지입니다. 각 메트릭 유형이 응답하는 방법에 대한 자세한 내용은 개별 메트릭 소스 유형을 참조하십시오. 설정되지 않은 경우 기본 메트릭은 평균 CPU 사용률의 80%로 설정됩니다.

metrics[]

object

MetricSpec은 단일 메트릭을 기반으로 스케일링하는 방법을 지정합니다( 유형 과 다른 일치하는 필드만 한 번에 설정되어야 함).

minReplicas

integer

minReplicas는 자동 스케일러가 축소할 수 있는 복제본 수의 더 낮은 제한입니다. 기본값은 1 pod입니다. 알파 기능 게이트 HPAScaleToZero가 활성화되고 하나 이상의 Object 또는 External 메트릭이 구성된 경우 minReplicas는 0이 될 수 있습니다. 하나 이상의 메트릭 값을 사용할 수 있는 경우 스케일링이 활성화됩니다.

scaleTargetRef

object

CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.

scaleDown

object

HPAScalingRules는 스케일링 정책 규칙 및 구성 가능한 메트릭 허용 오차를 통해 한 방향의 스케일링 동작을 구성합니다.

스케일링 정책 규칙은 HPA의 메트릭에서 DesiredReplicas를 계산한 후 적용됩니다. 스케일링 정책을 지정하여 스케일링 속도를 제한할 수 있습니다. 안정화 창을 지정하여 플러딩을 방지할 수 있으므로 복제본 수가 즉시 설정되지 않고 안정화 창에서 가장 안전한 값을 선택합니다.

허용 오차는 메트릭 값에 적용되며 작은 메트릭 변형에 대해 너무 신속하게 스케일링을 방지합니다. (Alerance를 설정하려면 alpha HPAConfigurableTolerance 기능 게이트를 활성화해야 합니다.)

scaleUp

object

HPAScalingRules는 스케일링 정책 규칙 및 구성 가능한 메트릭 허용 오차를 통해 한 방향의 스케일링 동작을 구성합니다.

스케일링 정책 규칙은 HPA의 메트릭에서 DesiredReplicas를 계산한 후 적용됩니다. 스케일링 정책을 지정하여 스케일링 속도를 제한할 수 있습니다. 안정화 창을 지정하여 플러딩을 방지할 수 있으므로 복제본 수가 즉시 설정되지 않고 안정화 창에서 가장 안전한 값을 선택합니다.

허용 오차는 메트릭 값에 적용되며 작은 메트릭 변형에 대해 너무 신속하게 스케일링을 방지합니다. (Alerance를 설정하려면 alpha HPAConfigurableTolerance 기능 게이트를 활성화해야 합니다.)

Policies

array

정책은 확장 중에 사용할 수 있는 잠재적인 확장 정책 목록입니다. 설정되지 않은 경우 기본값을 사용합니다. - 확장의 경우 Pod 수 또는 15s 창에서 4 Pod의 절대 변경을 허용합니다. - 축소의 경우 15s 창에서 모든 Pod를 제거할 수 있습니다.

policies[]

object

HPAScalingPolicy는 지정된 이전 간격에 대해 true를 유지해야 하는 단일 정책입니다.

selectPolicy

string

selectPolicy는 사용할 정책을 지정하는 데 사용됩니다. 설정되지 않은 경우 기본값인 Max가 사용됩니다.

stabilizationWindowSeconds

integer

stabilizationWindowSeconds는 확장 또는 축소하는 동안 이전 권장 사항을 고려해야 하는 시간(초)입니다. StabilizationWindowSeconds는 0보다 크거나 같고 3600(한 시간)보다 작거나 같아야 합니다. 설정되지 않은 경우 기본값을 사용합니다. - 확장의 경우 0(예: 안정화 작업이 수행되지 않음). - 스케일 다운의 경우 300(예: 안정화 창 길이는 300초)입니다.

허용

수량

허용 오차는 현재 및 원하는 메트릭 값 사이의 비율에 대한 허용 오차로, 원하는 복제본 수(예: 1%의 경우 0.01)에 대한 업데이트가 이루어지지 않습니다. 0보다 크거나 같아야 합니다. 설정되지 않은 경우 기본 클러스터 전체 허용 오차가 적용됩니다(기본값: 10%).

예를 들어, 자동 스케일링이 메모리 사용량 대상이 100Mi이고 5 %와 1%의 스케일 다운 및 스케일 업 허용 오차로 구성된 경우 실제 소비가 95% 미만이거나 101Mi를 초과하면 스케일링이 트리거됩니다.

alpha 필드이며 HPAConfigurableTolerance 기능 게이트를 활성화해야 합니다.

periodSeconds

integer

periodSeconds는 정책이 true를 유지해야 하는 시간 창을 지정합니다. PeriodSeconds는 0보다 크고 1800(30분)보다 작거나 같아야 합니다.

type

string

type은 스케일링 정책을 지정하는 데 사용됩니다.

value

integer

값에는 정책에서 허용하는 변경 횟수가 포함됩니다. 0보다 커야 합니다

Policies

array

정책은 확장 중에 사용할 수 있는 잠재적인 확장 정책 목록입니다. 설정되지 않은 경우 기본값을 사용합니다. - 확장의 경우 Pod 수 또는 15s 창에서 4 Pod의 절대 변경을 허용합니다. - 축소의 경우 15s 창에서 모든 Pod를 제거할 수 있습니다.

policies[]

object

HPAScalingPolicy는 지정된 이전 간격에 대해 true를 유지해야 하는 단일 정책입니다.

selectPolicy

string

selectPolicy는 사용할 정책을 지정하는 데 사용됩니다. 설정되지 않은 경우 기본값인 Max가 사용됩니다.

stabilizationWindowSeconds

integer

stabilizationWindowSeconds는 확장 또는 축소하는 동안 이전 권장 사항을 고려해야 하는 시간(초)입니다. StabilizationWindowSeconds는 0보다 크거나 같고 3600(한 시간)보다 작거나 같아야 합니다. 설정되지 않은 경우 기본값을 사용합니다. - 확장의 경우 0(예: 안정화 작업이 수행되지 않음). - 스케일 다운의 경우 300(예: 안정화 창 길이는 300초)입니다.

허용

수량

허용 오차는 현재 및 원하는 메트릭 값 사이의 비율에 대한 허용 오차로, 원하는 복제본 수(예: 1%의 경우 0.01)에 대한 업데이트가 이루어지지 않습니다. 0보다 크거나 같아야 합니다. 설정되지 않은 경우 기본 클러스터 전체 허용 오차가 적용됩니다(기본값: 10%).

예를 들어, 자동 스케일링이 메모리 사용량 대상이 100Mi이고 5 %와 1%의 스케일 다운 및 스케일 업 허용 오차로 구성된 경우 실제 소비가 95% 미만이거나 101Mi를 초과하면 스케일링이 트리거됩니다.

alpha 필드이며 HPAConfigurableTolerance 기능 게이트를 활성화해야 합니다.

periodSeconds

integer

periodSeconds는 정책이 true를 유지해야 하는 시간 창을 지정합니다. PeriodSeconds는 0보다 크고 1800(30분)보다 작거나 같아야 합니다.

type

string

type은 스케일링 정책을 지정하는 데 사용됩니다.

value

integer

값에는 정책에서 허용하는 변경 횟수가 포함됩니다. 0보다 커야 합니다

containerResource

object

ContainerResourceMetricSource는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 메트릭을 확장하여 현재 규모 대상(예: CPU 또는 메모리)의 각 Pod를 설명하는 방법을 나타냅니다. 값은 대상과 비교되기 전에 함께 평균화됩니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다. 하나의 "대상" 유형만 설정해야 합니다.

external

object

ExternalMetricSource는 Kubernetes 오브젝트와 연결되지 않은 메트릭(예: 클라우드 메시징 서비스의 큐 길이 또는 클러스터 외부에서 실행되는 로드 밸런서에서 QPS)을 스케일링하는 방법을 나타냅니다.

object

object

ObjectMetricSource는 kubernetes 오브젝트(예: Ingress 오브젝트의 hits-per-second)를 설명하는 메트릭을 스케일링하는 방법을 나타냅니다.

pods

object

PodsMetricSource는 현재 규모 대상(예: 트랜잭션 처리-초)의 각 Pod를 설명하는 메트릭을 스케일링하는 방법을 나타냅니다. 값은 대상 값과 비교되기 전에 함께 평균됩니다.

resource

object

ResourceMetricSource는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 메트릭을 스케일링하여 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod를 설명하는 방법을 나타냅니다. 값은 대상과 비교되기 전에 함께 평균화됩니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다. 하나의 "대상" 유형만 설정해야 합니다.

type

string

type은 지표 소스 유형입니다. "ContainerResource", "External", "Object", "Pods" 또는 "Resource" 중 하나여야 하며 각각 오브젝트의 일치하는 필드에 매핑해야 합니다.

container

string

컨테이너는 스케일링 대상의 Pod에 있는 컨테이너의 이름입니다.

name

string

name은 해당 리소스의 이름입니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

metric

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

describedObject

object

CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.

metric

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

apiVersion

string

apiVersion은 참조의 API 버전입니다.

kind

string

kind는 참조의 종류입니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

이름은 참조의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

metric

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

name

string

name은 해당 리소스의 이름입니다.

대상

object

MetricTarget은 특정 메트릭의 대상 값, 평균 값 또는 평균 사용률을 정의합니다.

averageUtilization

integer

averageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 대상 값입니다. 현재 리소스 메트릭 소스 유형에만 유효합니다.

averageValue

수량

AverageValue는 모든 관련 Pod에서 지표 평균의 대상 값입니다(수량)

type

string

type은 메트릭 유형이 Utilization, Value 또는 AverageValue인지 여부를 나타냅니다.

value

수량

값은 메트릭의 대상 값입니다(량)입니다.

apiVersion

string

apiVersion은 참조의 API 버전입니다.

kind

string

kind는 참조의 종류입니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

이름은 참조의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

conditions

array

조건은 이 자동 스케일러가 대상을 확장하는 데 필요한 조건 세트이며 해당 조건이 충족되는지 여부를 나타냅니다.

conditions[]

object

HorizontalPodAutoscalerCondition은 특정 시점에서 HorizontalPodAutoscaler의 상태를 설명합니다.

currentMetrics

array

currentMetrics는 이 자동 스케일러에서 사용하는 메트릭의 마지막 읽기 상태입니다.

currentMetrics[]

object

MetricStatus는 단일 메트릭의 마지막 읽기 상태를 설명합니다.

currentReplicas

integer

currentReplicas는 자동 스케일러에서 마지막으로 표시된 대로 이 자동 스케일러에서 관리하는 Pod의 현재 복제본 수입니다.

desiredReplicas

integer

desiredReplicas는 자동 스케일러에서 마지막으로 계산한 대로 이 자동 스케일러에서 관리하는 Pod의 원하는 수입니다.

lastScaleTime

시간

lastScaleTime은 HorizontalPodAutoscaler가 Pod 수를 변경하는 빈도를 제어하기 위해 자동 스케일러에서 사용하는 Pod 수를 마지막으로 스케일링한 시간입니다.

observedGeneration

integer

observedGeneration은 이 자동 스케일러에서 관찰하는 가장 최근 생성입니다.

lastTransitionTime

시간

lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다.

message

string

message는 전환에 대한 세부 정보가 포함된 사람이 읽을 수 있는 설명입니다.

reason

string

이유는 조건의 마지막 전환의 이유입니다.

status

string

status는 조건의 상태(True, False, Unknown)입니다.

type

string

type은 현재 조건을 설명합니다.

containerResource

object

ContainerResourceMetricStatus는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 지표의 현재 값을 나타내며, 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod에 단일 컨테이너를 설명합니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다.

external

object

ExternalMetricStatus는 Kubernetes 오브젝트와 연결되지 않은 글로벌 메트릭의 현재 값을 나타냅니다.

object

object

ObjectMetricStatus는 kubernetes 오브젝트(예: Ingress 오브젝트의 hits-per-second)를 설명하는 메트릭의 현재 값을 나타냅니다.

pods

object

PodsMetricStatus는 현재 스케일링 대상(예: transactions-processed-per-second)의 각 Pod를 설명하는 지표의 현재 값을 나타냅니다.

resource

object

ResourceMetricStatus는 요청 및 제한에 지정된 대로 Kubernetes에 알려진 리소스 지표의 현재 값을 나타내며, 현재 스케일 대상(예: CPU 또는 메모리)의 각 Pod를 설명합니다. 이러한 메트릭은 Kubernetes에 빌드되며 "pods" 소스를 사용하여 일반 Pod 지표에 사용할 수 있는 특수 확장 옵션이 있습니다.

type

string

type은 지표 소스 유형입니다. "ContainerResource", "External", "Object", "Pods" 또는 "Resource" 중 하나일 것이며 각각 오브젝트의 일치하는 필드에 해당합니다.

container

string

컨테이너는 스케일링 대상의 Pod에 있는 컨테이너의 이름입니다.

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

name

string

name은 해당 리소스의 이름입니다.

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

metric

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

describedObject

object

CrossVersionObjectReference에는 참조된 리소스를 식별할 수 있는 충분한 정보가 포함되어 있습니다.

metric

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

apiVersion

string

apiVersion은 참조의 API 버전입니다.

kind

string

kind는 참조의 종류입니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

이름은 참조의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

metric

object

MetricIdentifier는 메트릭의 이름과 선택적으로 선택기를 정의합니다.

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.

name

string

지정된 메트릭의 이름입니다.

선택기

LabelSelector

selector는 지정된 메트릭에 대한 표준 kubernetes 라벨 선택기의 문자열 인코딩 형식이며, 더 구체적인 메트릭 범위를 위해 메트릭 서버에 추가 매개변수로 전달됩니다. 설정되지 않은 경우 metricsName만 메트릭을 수집하는 데 사용됩니다.

current

object

MetricValueStatus에는 메트릭의 현재 값이 있습니다.

name

string

name은 해당 리소스의 이름입니다.

averageUtilization

integer

currentAverageUtilization은 Pod에 대해 요청된 리소스 값의 백분율로 표시되는 모든 관련 Pod의 리소스 지표 평균의 현재 값입니다.

averageValue

수량

AverageValue는 모든 관련 Pod(수량)에서 지표 평균의 현재 값입니다.

value

수량

value는 메트릭의 현재 값(량)입니다.