AWS::EKS::Nodegroup ScalingConfig

An object representing the scaling configuration details for the Auto Scaling group that is associated with your node group. When creating a node group, you must specify all or none of the properties. When updating a node group, you can specify any or none of the properties.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "DesiredSize" : Integer,
  "MaxSize" : Integer,
  "MinSize" : Integer
}

YAML

  DesiredSize: Integer
  MaxSize: Integer
  MinSize: Integer

Properties

DesiredSize

The current number of nodes that the managed node group should maintain.

Important

If you use Cluster Autoscaler, you shouldn't change the desiredSize value directly, as this can cause the Cluster Autoscaler to suddenly scale up or scale down.

Whenever this parameter changes, the number of worker nodes in the node group is updated to the specified size. If this parameter is given a value that is smaller than the current number of running worker nodes, the necessary number of worker nodes are terminated to match the given value. When using CloudFormation, no action occurs if you remove this parameter from your CFN template.

This parameter can be different from minSize in some cases, such as when starting with extra hosts for testing. This parameter can also be different when you want to start with an estimated number of needed hosts, but let Cluster Autoscaler reduce the number if there are too many. When Cluster Autoscaler is used, the desiredSize parameter is altered by Cluster Autoscaler (but can be out-of-date for short periods of time). Cluster Autoscaler doesn't scale a managed node group lower than minSize or higher than maxSize.

Required: No

Type: Integer

Minimum: 0

Update requires: No interruption

MaxSize

The maximum number of nodes that the managed node group can scale out to. For information about the maximum number that you can specify, see Amazon EKS service quotas in the Amazon EKS User Guide.

Required: No

Type: Integer

Minimum: 1

Update requires: No interruption

MinSize

The minimum number of nodes that the managed node group can scale in to.

Required: No

Type: Integer

Minimum: 0

Update requires: No interruption