Compartilhar via


Referência da API do Dimensionador Automático de Pod Vertical

Este artigo fornece a referência de API para o recurso Dimensionador Automático de Pod Vertical do Serviço de Kubernetes do Azure.

Esta referência é baseada na versão 0.13.0 da implementação do AKS do VPA.

VerticalPodAutoscaler

Nome Objeto Descrição
metadata ObjectMeta Metadados de objeto padrão.
spec VerticalPodAutoscalerSpec O comportamento desejado do Dimensionador Automático de Pod Vertical.
status VerticalPodAutoscalerStatus O status observado mais recentemente do Dimensionador Automático de Pod Vertical.

VerticalPodAutoscalerSpec

Nome Objeto Descrição
targetRef CrossVersionObjectReference Referência ao controlador que gerencia o conjunto de pods para controle do dimensionador automático. Por exemplo, uma Deployment ou um StatefulSet. Você pode apontar um Dimensionador Automático de Pod Vertical para qualquer controlador que tenha um sub-recurso Escala. Normalmente, o Dimensionador Automático de Pod Vertical recupera o conjunto de pods do ScaleStatus do controlador.
updatePolicy PodUpdatePolicy Especifica se as atualizações recomendadas são aplicadas quando um pod é iniciado e se elas são aplicadas durante a vida útil de um pod.
resourcePolicy PodResourcePolicy Especifica políticas de como as solicitações de CPU e memória são ajustadas para contêineres individuais. A política de recurso pode ser usada para definir restrições nas recomendações de contêineres individuais. Se isso não for especificado, o dimensionador automático computará os recursos recomendados para todos os contêineres no pod, sem restrições adicionais.
sistemas de recomendação VerticalPodAutoscalerRecommenderSelector O sistema de recomendação é responsável por gerar a recomendação para o objeto do VPA. Deixe-o vazio para usar o sistema de recomendação padrão. Caso contrário, a lista poderá conter exatamente uma entrada para um sistema de recomendação alternativo fornecido pelo usuário.

VerticalPodAutoscalerList

Nome Objeto Descrição
metadata ObjectMeta Metadados de objeto padrão.
itens VerticalPodAutoscaler (matriz) Uma lista de objetos do Dimensionador Automático de Pod Vertical.

PodUpdatePolicy

Nome Objeto Descrição
updateMode string Uma cadeia de caracteres que especifica se as atualizações recomendadas são aplicadas quando um pod é iniciado e se elas são aplicadas durante a vida útil de um pod. Os valores possíveis são Off, Initial, Recreate e Auto. O padrão será Auto se você não especificar um valor.
minReplicas int32 Um valor que representa o número mínimo de réplicas que precisam estar ativas para o Atualizador tentar a remoção do pod (pendente de outras verificações, como o Orçamento de Interrupção do Pod). Somente valores positivos são válidos. Usa como padrão o sinalizador global --min-replicas, que é definido como 2.

PodResourcePolicy

Nome Objeto Descrição
conainerPolicies ContainerResourcePolicy Uma matriz de políticas de recursos para contêineres individuais. Pode haver, no máximo, uma entrada para cada contêiner nomeado e, opcionalmente, uma só entrada curinga com containerName = '*', que processa todos os contêineres que não têm políticas individuais.

ContainerResourcePolicy

Nome Objeto Descrição
containerName string Uma cadeia de caracteres que especifica o nome do contêiner ao qual a política se aplica. Se ela não for especificada, a política servirá como a política padrão.
mode ContainerScalingMode Especifica se as atualizações recomendadas são aplicadas ao contêiner quando ele é iniciado e se elas são aplicadas durante a vida útil do contêiner. Os valores possíveis são Off e Auto. O padrão será Auto se você não especificar um valor.
minAllowed ResourceList Especifica a solicitação mínima de CPU e a solicitação de memória permitida para o contêiner. Por padrão, não há nenhum valor mínimo aplicado.
maxAllowed ResourceList Especifica a solicitação máxima de CPU e a solicitação de memória permitida para o contêiner. Por padrão, não há nenhum valor máximo aplicado.
ControlledResources []ResourceName Especifica os tipos de recomendações computadas (e possivelmente aplicadas) pelo Dimensionador Automático de Pod Vertical. Se isso estiver vazio, o padrão de [ResourceCPU, ResourceMemory] será usado.

VerticalPodAutoscalerRecommenderSelector

Nome Objeto Descrição
name string Uma cadeia de caracteres que especifica o nome do sistema de recomendação responsável por gerar a recomendação para esse objeto.

VerticalPodAutoscalerStatus

Nome Objeto Descrição
recomendação RecommendedPodResources As solicitações de CPU e de memória recomendadas mais recentemente.
conditions VerticalPodAutoscalerCondition Uma matriz que descreve o estado atual do Dimensionador Automático de Pod Vertical.

RecommendedPodResources

Nome Objeto Descrição
containerRecommendation RecommendedContainerResources Uma matriz de recomendações de recursos para contêineres individuais.

RecommendedContainerResources

Nome Objeto Descrição
containerName string Uma cadeia de caracteres que especifica o nome do contêiner ao qual a recomendação se aplica.
destino ResourceList As solicitações de CPU e de memória recomendadas para o contêiner.
lowerBound ResourceList As solicitações mínimas de CPU e de memória recomendadas para o contêiner. Não há garantia de que esse valor seja suficiente para que o aplicativo seja estável. A execução com solicitações menores de CPU e de memória provavelmente terá um impacto significativo no desempenho ou na disponibilidade.
upperBound ResourceList As solicitações máximas de CPU e de memória recomendadas para o contêiner. Solicitações de CPU e de memória maiores do que esses valores provavelmente serão desperdiçadas.
uncappedTarget ResourceList A recomendação de recurso mais recente computada pelo dimensionador automático, com base no uso real de recursos, não levando em conta a Política de Recurso do Contêiner. Se o uso real de recursos fizer com que o destino viole a Política de Recurso do Contêiner, isso poderá ser diferente da recomendação limitada. Esse campo não afeta a atribuição de recursos real. Ele só é usado como uma indicação de status.

VerticalPodAutoscalerCondition

Nome Objeto Descrição
tipo VerticalPodAutoscalerConditionType O tipo de condição que está sendo descrito. Os valores possíveis são RecommendationProvided, LowConfidence, NoPodsMatched e FetchingHistory.
status ConditionStatus O status da condição. Os valores possíveis são: True, False e Unknown.
lastTransitionTime Hora A última vez que a condição fez uma transição de um status para outro.
reason string O motivo da última transição de um status para outro.
message string Uma cadeia de caracteres legível por humanos que fornece detalhes sobre a última transição de um status para outro.

Próximas etapas

Confira Dimensionador Automático de Pod Vertical para entender como aprimorar a utilização de recursos de cluster e liberar CPU e memória para outros pods.