第 4 章 HorizontalPodAutoscaler [autoscaling/v2]

行为

object

HorizontalPodAutoscalerBehavior 在 Up 和 Down directions (scaleUp 和 scaleDown 字段)中分别配置目标的扩展行为。

maxReplicas

整数

maxReplicas 是自动扩展可以向上扩展的副本数的上限。minReplicas 不能小于该 minReplicas。

metrics

数组

指标包含用于计算所需副本数的规格（将使用所有指标的最大副本数）。所需的副本数乘以 target 值与当前 pod 数量之间的比率。在增加 pod 数量时，使用的指标必须减少，反之亦然。如需有关每种指标类型如何响应的更多信息，请参阅单独的指标源类型。如果没有设置，则默认指标将设置为 80% 平均 CPU 使用率。

metrics[]

object

MetricSpec 根据单一指标指定如何缩放（仅应一次设置 类型和 另一个匹配字段）。

minReplicas

整数

minReplicas 是自动扩展可以缩减的副本数的下限。如果启用了 alpha 功能门 HPAScaleToZero，并且至少配置一个 Object 或 External 指标，则默认为 1 个 pod。minReplicas 允许为 0。只要至少有一个指标值可用，缩放就会激活。

scaleTargetRef

对象

CrossVersionObjectReference 包含足够信息，以便您识别引用的资源。

scaleDown

object

HPAScalingRules 为一个方向配置扩展行为。这些规则在从 HPA 的指标计算 DesiredReplicas 后应用。它们可以通过指定扩展策略来限制扩展速度。它们可以通过指定 stabilization 窗口来防止阻塞，因此不会立即设置副本数，而是从 stabilization 窗口中选择安全的值。

scaleUp

object

HPAScalingRules 为一个方向配置扩展行为。这些规则在从 HPA 的指标计算 DesiredReplicas 后应用。它们可以通过指定扩展策略来限制扩展速度。它们可以通过指定 stabilization 窗口来防止阻塞，因此不会立即设置副本数，而是从 stabilization 窗口中选择安全的值。

policies

数组

策略是可以在扩展过程中使用的潜在缩放策略列表。必须至少指定一个策略，否则 HPAScalingRules 将被丢弃为无效

policies[]

object

HPAScalingPolicy 是一个单一策略，对于指定间隔，必须为 true。

selectPolicy

string

selectPolicy 用于指定要使用的策略。如果没有设置，则使用默认值 Max。

stabilizationWindowSeconds

整数

stabilizationWindowSeconds 是扩展或缩减时应考虑过去建议的秒数。stabilizationWindowSeconds 必须大于或等于 0，且小于或等于 3600 （一小时）。如果没有设置，请使用默认值： - 要扩展：0 （即没有稳定的静默功能）。- 要缩减 300 （例如，stabilization window 为 300 秒）。

periodSeconds

整数

periodSeconds 指定策略应为 true 的时间窗口。periodSeconds 必须大于零，且小于或等于 1800 (30 分钟)。

type

string

type 用于指定扩展策略。

value

整数

值包含策略所允许的更改量。它必须大于零

policies

数组

策略是可以在扩展过程中使用的潜在缩放策略列表。必须至少指定一个策略，否则 HPAScalingRules 将被丢弃为无效

policies[]

object

HPAScalingPolicy 是一个单一策略，对于指定间隔，必须为 true。

selectPolicy

string

selectPolicy 用于指定要使用的策略。如果没有设置，则使用默认值 Max。

stabilizationWindowSeconds

整数

stabilizationWindowSeconds 是扩展或缩减时应考虑过去建议的秒数。stabilizationWindowSeconds 必须大于或等于 0，且小于或等于 3600 （一小时）。如果没有设置，请使用默认值： - 要扩展：0 （即没有稳定的静默功能）。- 要缩减 300 （例如，stabilization window 为 300 秒）。

periodSeconds

整数

periodSeconds 指定策略应为 true 的时间窗口。periodSeconds 必须大于零，且小于或等于 1800 (30 分钟)。

type

string

type 用于指定扩展策略。

value

整数

值包含策略所允许的更改量。它必须大于零

containerResource

object

ContainerResourceMetricSource 指示如何扩展 Kubernetes 已知的资源指标，如请求和限值中指定的，描述当前 scale 目标中的每个 pod （如 CPU 或内存）。与目标相比，这些值将平均合上。此类指标内置在 Kubernetes 中，并且具有特殊的扩展选项，它们之上使用 "pods" 源的普通每个 pod 指标。应该只设置一个"目标"类型。

external

object

ExternalMetricSource 表示如何在不与任何 Kubernetes 对象关联的指标上扩展（例如，云消息传递服务中的队列长度，或从集群外运行的 loadbalancer 中的 QPS）。

object

object

ObjectMetricSource 指示如何在描述 kubernetes 对象的指标上缩放（例如，Ingress 对象上的 hits-per-second）。

pods

object

PodsMetricSource 表示如何在当前 scale 目标中描述每个 pod 的指标（例如，Transaction-processed-per-second）。这些值在与 target 值进行比较之前会平均在一起。

resource

object

ResourceMetricSource 指示如何缩放 Kubernetes 已知资源指标（如请求和限值中指定的），描述当前规模目标中的每个 pod （如 CPU 或内存）。与目标相比，这些值将平均合上。此类指标内置在 Kubernetes 中，并且具有特殊的扩展选项，它们之上使用 "pods" 源的普通每个 pod 指标。应该只设置一个"目标"类型。

type

string

type 是指标源的类型。它应该是 "ContainerResource", "External", "Object", "Pods" 或 "Resource" 之一，每个映射到对象中的匹配字段。注："ContainerResource" 类型在启用了 feature-gate HPAContainerMetrics 时可用

container

string

container 是扩展目标 pod 中的容器名称

名称

string

name 是有问题的资源的名称。

target

object

MetricTarget 定义特定指标的目标值、平均值或平均利用率

averageUtilization

整数

averageUtilization 是所有相关 pod 中资源指标平均值的目标值，以 pod 资源请求的值的百分比表示。目前仅对 Resource 指标源类型有效

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的目标值（作为数量）

type

string

type 代表指标类型是 Utilization、Value 或 AverageValue

value

数量

值是指标（作为一个数量）的目标值。

metric

object

MetricIdentifier 定义指标的名称和可选选择器

target

object

MetricTarget 定义特定指标的目标值、平均值或平均利用率

name

string

name 是给定指标的名称

selector

LabelSelector

选择器是在设置时给定指标的标准 kubernetes 标签选择器的字符串编码形式，它会作为额外参数传递给指标服务器，以进行更具体的指标范围。如果未设置，只有 metricName 将用于收集指标。

averageUtilization

整数

averageUtilization 是所有相关 pod 中资源指标平均值的目标值，以 pod 资源请求的值的百分比表示。目前仅对 Resource 指标源类型有效

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的目标值（作为数量）

type

string

type 代表指标类型是 Utilization、Value 或 AverageValue

value

数量

值是指标（作为一个数量）的目标值。

describedObject

object

CrossVersionObjectReference 包含足够信息，以便您识别引用的资源。

metric

object

MetricIdentifier 定义指标的名称和可选选择器

target

object

MetricTarget 定义特定指标的目标值、平均值或平均利用率

apiVersion

string

apiVersion 是引用的 API 版本

kind

string

kind 是引用的类型；更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

名称

string

name 是引用的名称；更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

name

string

name 是给定指标的名称

selector

LabelSelector

选择器是在设置时给定指标的标准 kubernetes 标签选择器的字符串编码形式，它会作为额外参数传递给指标服务器，以进行更具体的指标范围。如果未设置，只有 metricName 将用于收集指标。

averageUtilization

整数

averageUtilization 是所有相关 pod 中资源指标平均值的目标值，以 pod 资源请求的值的百分比表示。目前仅对 Resource 指标源类型有效

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的目标值（作为数量）

type

string

type 代表指标类型是 Utilization、Value 或 AverageValue

value

数量

值是指标（作为一个数量）的目标值。

metric

object

MetricIdentifier 定义指标的名称和可选选择器

target

object

MetricTarget 定义特定指标的目标值、平均值或平均利用率

name

string

name 是给定指标的名称

selector

LabelSelector

选择器是在设置时给定指标的标准 kubernetes 标签选择器的字符串编码形式，它会作为额外参数传递给指标服务器，以进行更具体的指标范围。如果未设置，只有 metricName 将用于收集指标。

averageUtilization

整数

averageUtilization 是所有相关 pod 中资源指标平均值的目标值，以 pod 资源请求的值的百分比表示。目前仅对 Resource 指标源类型有效

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的目标值（作为数量）

type

string

type 代表指标类型是 Utilization、Value 或 AverageValue

value

数量

值是指标（作为一个数量）的目标值。

name

string

name 是有问题的资源的名称。

target

object

MetricTarget 定义特定指标的目标值、平均值或平均利用率

averageUtilization

整数

averageUtilization 是所有相关 pod 中资源指标平均值的目标值，以 pod 资源请求的值的百分比表示。目前仅对 Resource 指标源类型有效

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

名称

string

name 是引用的名称；更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

conditions

数组

条件是一组此自动扩展用来扩展其目标的条件，并指示是否满足这些条件。

conditions[]

object

HorizontalPodAutoscalerCondition 描述了特定点的 HorizontalPodAutoscaler 的状态。

currentMetrics

数组

currentMetrics 是此自动扩展使用的指标的最后一个读取状态。

currentMetrics[]

object

MetricStatus 描述了单个指标的最后读取状态。

currentReplicas

整数

currentReplicas 是此自动扩展管理的 pod 数量的当前数量，如自动扩展最后看到。

desiredReplicas

整数

desiredReplicas 是此自动扩展管理的 pod 数量所需的副本数，如自动扩展最后计算。

lastScaleTime

时间

lastScaleTime 是 HorizontalPodAutoscaler 最后一次扩展 pod 数量的时间，供自动扩展用来控制 pod 数量的变化频率。

observedGeneration

整数

observedGeneration 是此自动扩展观察到的最新生成。

lastTransitionTime

时间

lastTransitionTime 是条件从一个状态转换到另一个状态最后一次的时间

message

string

Message 是人类可读的解释，其中包含有关转换的详细信息

reason

字符串

reason 是条件最后一次转换的原因。

status

string

status 是条件的状态(True, False, Unknown)

type

string

type 描述了当前的条件

containerResource

object

ContainerResourceMetricStatus 指示 Kubernetes 已知的资源指标的当前值，如请求和限值中指定的，描述当前 scale 目标（如 CPU 或内存）中的每个 pod 中的单个容器。此类指标内置在 Kubernetes 中，并且具有特殊的扩展选项，它们之上使用 "pods" 源的普通每个 pod 指标。

external

object

ExternalMetricStatus 表示没有与任何 Kubernetes 对象关联的全局指标的当前值。

object

object

ObjectMetricStatus 指示描述 kubernetes 对象的指标的当前值（例如，Ingress 对象上的 hits-per-second）。

pods

object

PodsMetricStatus 表示在当前 scale 目标中描述每个 pod 的指标的当前值（如 transactions-processed-per-second）。

resource

object

ResourceMetricStatus 指示 Kubernetes 已知的资源指标的当前值，如请求和限值中指定的，描述当前 scale 目标中的每个 pod （如 CPU 或内存）。此类指标内置在 Kubernetes 中，并且具有特殊的扩展选项，它们之上使用 "pods" 源的普通每个 pod 指标。

type

string

type 是指标源的类型。它将是 "ContainerResource", "External", "Object", "Pods" 或 "Resource" 之一，每个项对应于对象中的匹配字段。注："ContainerResource" 类型在启用了 feature-gate HPAContainerMetrics 时可用

container

string

container 是扩展目标 pod 中的容器名称

current

object

MetricValueStatus 包含指标的当前值

名称

string

name 是有问题的资源的名称。

averageUtilization

整数

currentAverageUtilization 是所有相关 pod 中资源指标平均值的当前值，以 pod 资源请求的值的百分比表示。

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的当前值（作为数量）

value

数量

值是指标（作为一个数量）的当前值。

current

object

MetricValueStatus 包含指标的当前值

metric

object

MetricIdentifier 定义指标的名称和可选选择器

averageUtilization

整数

currentAverageUtilization 是所有相关 pod 中资源指标平均值的当前值，以 pod 资源请求的值的百分比表示。

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的当前值（作为数量）

value

数量

值是指标（作为一个数量）的当前值。

name

string

name 是给定指标的名称

selector

LabelSelector

选择器是在设置时给定指标的标准 kubernetes 标签选择器的字符串编码形式，它会作为额外参数传递给指标服务器，以进行更具体的指标范围。如果未设置，只有 metricName 将用于收集指标。

current

object

MetricValueStatus 包含指标的当前值

describedObject

object

CrossVersionObjectReference 包含足够信息，以便您识别引用的资源。

metric

object

MetricIdentifier 定义指标的名称和可选选择器

averageUtilization

整数

currentAverageUtilization 是所有相关 pod 中资源指标平均值的当前值，以 pod 资源请求的值的百分比表示。

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的当前值（作为数量）

value

数量

值是指标（作为一个数量）的当前值。

apiVersion

string

apiVersion 是引用的 API 版本

kind

string

kind 是引用的类型；更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

名称

string

name 是引用的名称；更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

name

string

name 是给定指标的名称

selector

LabelSelector

选择器是在设置时给定指标的标准 kubernetes 标签选择器的字符串编码形式，它会作为额外参数传递给指标服务器，以进行更具体的指标范围。如果未设置，只有 metricName 将用于收集指标。

current

object

MetricValueStatus 包含指标的当前值

metric

object

MetricIdentifier 定义指标的名称和可选选择器

averageUtilization

整数

currentAverageUtilization 是所有相关 pod 中资源指标平均值的当前值，以 pod 资源请求的值的百分比表示。

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的当前值（作为数量）

value

数量

值是指标（作为一个数量）的当前值。

name

string

name 是给定指标的名称

selector

LabelSelector

选择器是在设置时给定指标的标准 kubernetes 标签选择器的字符串编码形式，它会作为额外参数传递给指标服务器，以进行更具体的指标范围。如果未设置，只有 metricName 将用于收集指标。

current

object

MetricValueStatus 包含指标的当前值

名称

string

name 是有问题的资源的名称。

averageUtilization

整数

currentAverageUtilization 是所有相关 pod 中资源指标平均值的当前值，以 pod 资源请求的值的百分比表示。

averageValue

数量

AverageValue 是所有相关 pod 间的指标平均值的当前值（作为数量）

value

数量

值是指标（作为一个数量）的当前值。