VerticalPodAutoscaler

Scope: Namespaced

VerticalPodAutoscaler is the configuration for a vertical Pod autoscaler, which automatically manages Pod resources based on historical and real time resource utilization.

  • specobject

    Required value

    • resourcePolicyobject

      Controls how the autoscaler computes recommended resources. The resource policy may be used to set constraints on the recommendations for individual containers. If not specified, the autoscaler computes recommended resources for all containers in the pod, without additional constraints.

      • containerPoliciesarray of objects

        Per-container resource policies.

        • containerNamestring

          Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don’t have their own policy specified.

        • controlledResourcesarray of strings

          Specifies the type of recommendations that will be computed (and possibly applied) by VPA.

          Default: ["ResourceCPU","ResourceMemory"]

          ResourceName is the name identifying various resources in a ResourceList.

        • controlledValuesstring

          Specifies which resource values should be controlled.

          Default: "RequestsAndLimits"

          Allowed values: RequestsAndLimits, RequestsOnly

        • maxAllowedobject

          Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.

        • minAllowedobject

          Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.

        • modestring

          Whether autoscaler is enabled for the container.

          Default: "Auto"

          Allowed values: Auto, Off

    • targetRefobject

      Required value

      Refers to a Kubernetes controller object responsible for managing pods.

      All common controller types are supported: Deployment, StatefulSet, DaemonSet, CronJobs, and any custom types with a scale sub-resource.

      • apiVersionstring

        API version of the object.

      • kindstring

        Required value

        Object type.

      • namestring

        Required value

        Object name.

    • updatePolicyobject

      Describes the rules on how changes are applied to the pods. If not specified, all fields in the PodUpdatePolicy are set to their default values.

      • updateModestring

        The operation mode of the VPA controller

        • Auto — currently, Auto and Recreate modes do the same thing. This mode is reserved for the Pod inplace resource update in Kubernetes.
        • Recreate — this mode allows VPA to modify resource requirements of the running pods (i.e., restart them during operation). This mode might result in temporary unavailability of the service (due to restart) if you have just one replica (replicas: 1). In this mode, VPA does not recreate pods that were not created by a controller.
        • Initial — VPA modifies pod resources only when pods are started (but not when pods are running).
        • Off — VPA does not take any action to update the resource requests for the running containers. Autoscaler calculates recomendations and stores them in the status field of the VPA object. You can browse VPA recommendations using the following command: kubectl describe vpa <vpa-name>.

        Default: "Auto"

        Allowed values: Off, Initial, Recreate, Auto

VerticalPodAutoscaler is the configuration for a vertical Pod autoscaler, which automatically manages Pod resources based on historical and real time resource utilization.

  • specobject

    Required value

    • resourcePolicyobject

      Controls how the autoscaler computes recommended resources. The resource policy may be used to set constraints on the recommendations for individual containers. If not specified, the autoscaler computes recommended resources for all containers in the pod, without additional constraints.

      • containerPoliciesarray of objects

        Per-container resource policies.

        • containerNamestring

          Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don’t have their own policy specified.

        • controlledResourcesarray of strings

          Specifies the type of recommendations that will be computed (and possibly applied) by VPA.

          Default: ["ResourceCPU","ResourceMemory"]

          ResourceName is the name identifying various resources in a ResourceList.

        • controlledValuesstring

          Specifies which resource values should be controlled.

          Default: "RequestsAndLimits"

          Allowed values: RequestsAndLimits, RequestsOnly

        • maxAllowedobject

          Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.

        • minAllowedobject

          Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.

        • modestring

          Whether autoscaler is enabled for the container.

          Default: "Auto"

          Allowed values: Auto, Off

    • targetRefobject

      Required value

      Refers to a Kubernetes controller object responsible for managing pods.

      All common controller types are supported: Deployment, StatefulSet, DaemonSet, CronJobs, and any custom types with a scale sub-resource.

      • apiVersionstring

        API version of the object.

      • kindstring

        Required value

        Object type.

      • namestring

        Required value

        Object name.

    • updatePolicyobject

      Describes the rules on how changes are applied to the pods. If not specified, all fields in the PodUpdatePolicy are set to their default values.

      • updateModestring

        The operation mode of the VPA controller

        • Auto — currently, Auto and Recreate modes do the same thing. This mode is reserved for the Pod inplace resource update in Kubernetes.
        • Recreate — this mode allows VPA to modify resource requirements of the running pods (i.e., restart them during operation). This mode might result in temporary unavailability of the service (due to restart) if you have just one replica (replicas: 1). In this mode, VPA does not recreate pods that were not created by a controller.
        • Initial — VPA modifies pod resources only when pods are started (but not when pods are running).
        • Off — VPA does not take any action to update the resource requests for the running containers. Autoscaler calculates recomendations and stores them in the status field of the VPA object. You can browse VPA recommendations using the following command: kubectl describe vpa <vpa-name>.

        Default: "Auto"

        Allowed values: Off, Initial, Recreate, Auto

VerticalPodAutoscaler is the configuration for a vertical Pod autoscaler, which automatically manages Pod resources based on historical and real time resource utilization.

  • specobject

    Required value

    • resourcePolicyobject

      Controls how the autoscaler computes recommended resources. The resource policy may be used to set constraints on the recommendations for individual containers. If not specified, the autoscaler computes recommended resources for all containers in the pod, without additional constraints.

      • containerPoliciesarray of objects

        Per-container resource policies.

        • containerNamestring

          Name of the container or DefaultContainerResourcePolicy, in which case the policy is used by the containers that don’t have their own policy specified.

        • controlledResourcesarray of strings

          Specifies the type of recommendations that will be computed (and possibly applied) by VPA.

          Default: ["ResourceCPU","ResourceMemory"]

          ResourceName is the name identifying various resources in a ResourceList.

        • controlledValuesstring

          Specifies which resource values should be controlled.

          Default: "RequestsAndLimits"

          Allowed values: RequestsAndLimits, RequestsOnly

        • maxAllowedobject

          Specifies the maximum amount of resources that will be recommended for the container. The default is no maximum.

        • minAllowedobject

          Specifies the minimal amount of resources that will be recommended for the container. The default is no minimum.

        • modestring

          Whether autoscaler is enabled for the container.

          Default: "Auto"

          Allowed values: Auto, Off

    • targetRefobject

      Required value

      Refers to a Kubernetes controller object responsible for managing pods.

      All common controller types are supported: Deployment, StatefulSet, DaemonSet, CronJobs, and any custom types with a scale sub-resource.

      • apiVersionstring

        API version of the object.

      • kindstring

        Required value

        Object type.

      • namestring

        Required value

        Object name.

    • updatePolicyobject

      Describes the rules on how changes are applied to the pods. If not specified, all fields in the PodUpdatePolicy are set to their default values.

      • updateModestring

        The operation mode of the VPA controller

        • Auto — currently, Auto and Recreate modes do the same thing. This mode is reserved for the Pod inplace resource update in Kubernetes.
        • Recreate — this mode allows VPA to modify resource requirements of the running pods (i.e., restart them during operation). This mode might result in temporary unavailability of the service (due to restart) if you have just one replica (replicas: 1). In this mode, VPA does not recreate pods that were not created by a controller.
        • Initial — VPA modifies pod resources only when pods are started (but not when pods are running).
        • Off — VPA does not take any action to update the resource requests for the running containers. Autoscaler calculates recomendations and stores them in the status field of the VPA object. You can browse VPA recommendations using the following command: kubectl describe vpa <vpa-name>.

        Default: "Auto"

        Allowed values: Off, Initial, Recreate, Auto