Migra entre las versiones de la API de VerticalPodAutoscaler

Beta

Este producto o función está cubierto por los Términos de las Ofertas Previas a la Disponibilidad General de los Términos del Servicio de Google Cloud Platform. Las funciones y los productos previos a la disponibilidad general pueden tener una asistencia limitada y los cambios que se produzcan en ellos podrían no ser compatibles con otras versiones previas a la disponibilidad general. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En esta página, se explica cómo migrar objetos VerticalPodAutoscaler de las versión de la API v1beta1 a v1beta2.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

• Asegúrate de que habilitaste la API de Google Kubernetes Engine.
Habilitar la API de Google Kubernetes Engine
• Asegúrate de que instalaste el SDK de Cloud.

Establece la configuración de gcloud predeterminada mediante uno de los siguientes métodos:

• Usa gcloud init si deseas ver una explicación sobre cómo configurar parámetros predeterminados.
• Usa gcloud config para establecer el ID, la zona y la región del proyecto de manera individual.

Usa gcloud init

Si recibes el error One of [--zone, --region] must be supplied: Please specify location, completa esta sección.

1. Ejecuta gcloud init y sigue las instrucciones:

   gcloud init

   Si usas SSH en un servidor remoto, usa la marca --console-only para evitar que el comando abra un navegador:

   gcloud init --console-only

2. Sigue las instrucciones a fin de autorizar a gcloud para que use tu cuenta de Google Cloud.
3. Crea una configuración nueva o selecciona una existente.
4. Elige un proyecto de Google Cloud.
5. Elige una zona predeterminada de Compute Engine.

Nota: Puedes anular esta configuración predeterminada en los comandos de gcloud mediante las marcas --project, --zone y --region.

Usa gcloud config

• Establece tu ID del proyecto predeterminado:

  gcloud config set project project-id

• Si trabajas con clústeres zonales, establece tu zona de procesamiento predeterminada:

  gcloud config set compute/zone compute-zone

• Si trabajas con clústeres regionales, establece tu región de procesamiento predeterminada:

  gcloud config set compute/region compute-region

• Actualiza gcloud a la versión más reciente:

  gcloud components update

Nota: Puedes anular esta configuración predeterminada en los comandos de gcloud mediante las marcas --project, --zone y --region.

Habilita el ajuste de escala automático vertical de pods para un clúster

Para crear un clúster nuevo con ajuste de escala automático vertical de Pods habilitado, ingresa el siguiente comando:

gcloud beta container clusters create cluster-name --enable-vertical-pod-autoscaling

En el ejemplo anterior, cluster-name es un nombre que eliges para el clúster nuevo.

Si quieres habilitar el ajuste de escala automático vertical de Pods para un clúster existente, ingresa el siguiente comando:

gcloud beta container clusters update cluster-name --enable-vertical-pod-autoscaling

En el ejemplo anterior, cluster-name es el nombre del clúster existente.

Presentamos la API de v1beta2

El ajuste de escala automático vertical de pods es una función Beta que se incluyó en la versión 1.11 de GKE. En la API de v1beta1, se usa un selector de etiquetas para especificar qué pods pertenecen a un VerticalPodAutoscaler determinado. Recopilamos los comentarios de los usuarios y decidimos modificar la API por razones de usabilidad:

• El uso de selectores es propenso a generar configuraciones incorrectas. Por ejemplo, un objeto VerticalPodAutoscaler se orienta a todos los pods de un clúster o a los pods que pertenecen a más de un objeto VerticalPodAutoscaler.
• Sin duda, el caso práctico más común es que un VerticalPodAutoscaler se oriente a una implementación completa.
• Este cambio alinea el VPA con la API de HorizontalPodAutoscaler.

Con la API de v1beta2, un objeto VerticalPodAutoscaler apunta directamente a un controlador, por ejemplo, una implementación o un DaemonSet.

Nota: La API de v1beta2 está disponible en Google Kubernetes Engine versión 1.11 a partir de la versión 1.11.8 y en todos los clústeres con la versión 1.12.6 o superior. La API de v1beta1 está obsoleta en la versión 1.12 y se quitará en la versión 1.13.

Migra de la API de v1beta1 a la de v1beta2

En esta guía, se muestra cómo migrar con seguridad una implementación escalada mediante VerticalPodAutoscaler de v1beta1 a v1beta2.

A continuación, se muestra un manifiesto de ejemplo para un Deployment:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment-name
  labels:
    label: vpa-label
spec:
  replicas: 2
  selector:
    matchLabels:
      label: vpa-label
  template:
    metadata:
      labels:
        label: vpa-label
    spec:
      containers:
      - {...}

En v1beta1, para escalar el VerticalPodAutoscaler debes especificar un selector a fin de que coincida con todos los pods en el Deployment:

apiVersion: autoscaling.k8s.io/v1beta1
kind: VerticalPodAutoscaler
metadata:
  name: vpa-name
spec:
  selector:
    matchLabels:
      label: vpa-label
  updatePolicy:
    updateMode: {...}

En la versión v1beta2, el VerticalPodAutoscaler apunta directamente a Deployment:

apiVersion: autoscaling.k8s.io/v1beta2 # different API version
kind: VerticalPodAutoscaler
metadata:
  name: vpa-name
spec:
  targetRef:
    apiVersion: "apps/v1"
    kind:       Deployment
    name:       deployment-name
  updatePolicy:
    updateMode: {...}

Guarda el manifiesto de v1beta2 en un archivo llamado vpa-v1beta2.yaml.

Si el updateMode está configurado como "Off", puedes ejecutar el siguiente comando:

kubectl apply -f vpa-v1beta2.yaml

El VerticalPodAutoscaler mantendrá las recomendaciones durante el cambio.

Si el updateMode está activado ("Initial", "Auto" o "Recreate"), debes realizar la migración en varios pasos:

1. Crea un manifiesto de VerticalPodAutoscaler v1beta2 con un nombre nuevo (vpa-name-new) y el campo updateMode configurado como "Off":

   apiVersion: autoscaling.k8s.io/v1beta2
   kind: VerticalPodAutoscaler
   metadata:
     name: vpa-name-new # Different name
   spec:
     targetRef:
       apiVersion: "apps/v1"
       kind:       Deployment
       name:       deployment-name
     updatePolicy:
       updateMode: "Off" # Recommendation only mode.
   

2. Guarda este manifiesto como vpa-v1beta1-off.yaml.

3. Crea el objeto VerticalPodAutoscaler nuevo:

   kubectl apply -f vpa-v1beta1-off.yaml
   

4. Espera a que se propague la recomendación y compárala con la del objeto VerticalPodAutoscaler original.

5. Cuando estés satisfecho con la coincidencia de las recomendaciones, borra el objeto VerticalPodAutoscaler v1beta1:

   kubectl delete vpa-name
   

6. Actualiza el VerticalPodAutoscaler nuevo a tu estrategia de actualización original. Por ejemplo, para updateMode: "Auto":

   apiVersion: autoscaling.k8s.io/v1beta2
   kind: VerticalPodAutoscaler
   metadata:
     name: vpa-name-new
   spec:
     targetRef:
       apiVersion: "apps/v1"
       kind:       Deployment
       name:       deployment-name
     updatePolicy:
       updateMode: "Auto" # Mode switched to auto
   

7. Guarda este manifiesto como vpa-v1beta1-final.yaml.

8. Aplica la configuración nueva:

   kubectl apply -f vpa-v1beta1-final.yaml
   

Referencia

Esta es la referencia de la API de v1beta1. También puedes consultar la referencia de v1beta2

VerticalPodAutoscaler v1beta1 autoscaling.k8s.io

Campos
	TypeMeta Grupo de API, versión y tipo
metadata	ObjectMeta Metadatos de objeto estándar.
spec	VerticalPodAutoscalerSpec El comportamiento deseado del VerticalPodAutoscaler.
status	VerticalPodAutosclerStatus El estado más reciente del VerticalPodAutoscaler.

VerticalPodAutoscalerSpec v1beta1 autoscaling.k8s.io

Campos
selector	LabelSelector Una consulta de etiqueta que determina el conjunto de pods que controla el VerticalPodAutoscaler.
updatePolicy	PodUpdatePolicy Especifica si se aplican las actualizaciones recomendadas cuando se inicia un pod, y si las actualizaciones recomendadas se aplican durante la vida útil del pod.
resourcePolicy	PodResourcePolicy Especifica las políticas sobre cómo se ajustan los requisitos de CPU y memoria para los contenedores individuales.

VerticalPodAutoscalerList v1beta1 autoscaling.k8s.io

Campos
	TypeMeta Grupo de API, versión y tipo
metadata	ObjectMeta Metadatos de objeto estándar.
items	VerticalPodAutoscaler array Una lista de objetos de VerticalPodAutoscaler.

PodUpdatePolicy v1beta1 autoscaling.k8s.io

Campos
updateMode	string Especifica si se aplican las actualizaciones recomendadas cuando se inicia un pod, y si las actualizaciones recomendadas se aplican durante la vida útil del pod. Los valores posibles son “Apagado”, “Inicial”, “Volver a crear” y “Auto”.

PodResourcePolicy v1beta1 autoscaling.k8s.io

Campos
containerPolicies	ContainerResourcePolicy array Un arreglo de políticas de recursos para contenedores individuales.

ContainerResourcePolicy v1beta1 autoscaling.k8s.io

Campos
containerName	string El nombre del contenedor al cual se aplica la política. Si no se especifica, la política se usa como política predeterminada.
mode	ContainerScalingMode Especifica si se aplican las actualizaciones recomendadas cuando se inicia un contenedor, y si las actualizaciones recomendadas se aplican durante la vida útil del contenedor. Los valores posibles son “Apagado” o “Auto”.
minAllowed	ResourceList Especifica los requisitos de CPU y memoria mínimos que se permiten para el contenedor.
maxAllowed	ResourceList Especifica los requisitos de CPU y memoria máximos que se permiten para el contenedor.

VerticalPodAutoscalerStatus v1beta1 autoscaling.k8s.io

Campos
recommendation	RecommendedPodResources Los requisitos de CPU y memoria recomendados más recientes.
conditions	VerticalPodAutoscalerCondition array Describe el estado actual del VerticalPodAutoscaler.

RecommendedPodResources v1beta1 autoscaling.k8s.io

Campos
containerRecommendation	RecommendedContainerResources array Un arreglo de recomendaciones de recursos para contenedores individuales.

RecommendedContainerResources v1beta1 autoscaling.k8s.io

Campos
containerName	string El nombre del contenedor al cual se aplica la recomendación.
target	ResourceList Los requisitos de CPU y memoria recomendados para el contenedor.
lowerBound	ResourceList Los requisitos de CPU y memoria mínimos recomendados para el contenedor. No se garantiza que esta cantidad sea suficiente para que la aplicación permanezca estable. Es probable que la ejecución con menos requisitos de CPU y memoria tenga un impacto considerable en el rendimiento o la disponibilidad.
upperBound	ResourceList Los requisitos de CPU y memoria máximos recomendados para el contenedor. Es probable que los requisitos de CPU y memoria que superen estos valores se desperdicien.
uncappedTarget	ResourceList La recomendación de recursos más reciente que procesó el escalador automático, solo en función del uso real de recursos y sin tener en cuenta la ContainerResourcePolicy. Puede variar de la recomendación delimitada si el uso real de recursos hace que el objetivo viole la ContainerResourcePolicy. Este campo solo se usa como indicador de estado; no afecta la asignación real de recursos.

VerticalPodAutoscalerCondition v1beta1 autoscaling.k8s.io

Campos
type	VerticalPodAutoscalerConditionType El tipo de condición que se describe. Los valores posibles son “RecommendationProvided”, “LowConfidence”, “NoPodsMatched” y “FetchingHistory”.
status	ConditionStatus El estado de la condición. Los posibles valores son Verdadero, Falso y Desconocido.
lastTransitionTime	Time La última vez que la condición hizo una transición de un estado a otro.
reason	string La razón por la cual se realizó la última transición de un estado a otro.
message	string Una string legible que proporciona detalles sobre la última transición de un estado a otro.