Package software.amazon.awscdk.services.eks

Interface CfnNodegroup.ScalingConfigProperty

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnNodegroup.ScalingConfigProperty.Jsii$Proxy

Enclosing class:

CfnNodegroup

@Stability(Stable)
public static interface CfnNodegroup.ScalingConfigProperty
extends software.amazon.jsii.JsiiSerializable

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.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.eks.*;
 ScalingConfigProperty scalingConfigProperty = ScalingConfigProperty.builder()
         .desiredSize(123)
         .maxSize(123)
         .minSize(123)
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-eks-nodegroup-scalingconfig.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnNodegroup.ScalingConfigProperty.Builder	A builder for CfnNodegroup.ScalingConfigProperty
static final class	CfnNodegroup.ScalingConfigProperty.Jsii$Proxy	An implementation for CfnNodegroup.ScalingConfigProperty

Method Summary

Modifier and Type	Method	Description
static CfnNodegroup.ScalingConfigProperty.Builder	builder()
default Number	getDesiredSize()	The current number of nodes that the managed node group should maintain.
default Number	getMaxSize()	The maximum number of nodes that the managed node group can scale out to.
default Number	getMinSize()	The minimum number of nodes that the managed node group can scale in to.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getDesiredSize

@Stability(Stable)
@Nullable
default Number getDesiredSize()

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

If you use the Kubernetes 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 the Cluster Autoscaler reduce the number if there are too many. When the Cluster Autoscaler is used, the desiredSize parameter is altered by the Cluster Autoscaler (but can be out-of-date for short periods of time). the Cluster Autoscaler doesn't scale a managed node group lower than minSize or higher than maxSize .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-eks-nodegroup-scalingconfig.html#cfn-eks-nodegroup-scalingconfig-desiredsize

getMaxSize

@Stability(Stable)
@Nullable
default Number getMaxSize()

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 .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-eks-nodegroup-scalingconfig.html#cfn-eks-nodegroup-scalingconfig-maxsize

getMinSize

@Stability(Stable)
@Nullable
default Number getMinSize()

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

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-eks-nodegroup-scalingconfig.html#cfn-eks-nodegroup-scalingconfig-minsize

builder

@Stability(Stable)
static CfnNodegroup.ScalingConfigProperty.Builder builder()

Returns:

a CfnNodegroup.ScalingConfigProperty.Builder of CfnNodegroup.ScalingConfigProperty