Package software.amazon.awscdk.services.eks_v2

Interface ClusterProps

All Superinterfaces:
ClusterCommonOptions, software.amazon.jsii.JsiiSerializable
All Known Implementing Classes:
ClusterProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.126.0 (build 206d44b)", date="2026-02-23T18:58:18.912Z") @Stability(Stable) public interface ClusterProps extends software.amazon.jsii.JsiiSerializable, ClusterCommonOptions
Properties for configuring a standard EKS cluster (non-Fargate).

Example: 

 Cluster cluster = Cluster.Builder.create(this, "ManagedNodeCluster")
         .version(KubernetesVersion.V1_34)
         .defaultCapacityType(DefaultCapacityType.NODEGROUP)
         .build();
 // Add a Fargate Profile for specific workloads (e.g., default namespace)
 cluster.addFargateProfile("FargateProfile", FargateProfileOptions.builder()
         .selectors(List.of(Selector.builder().namespace("default").build()))
         .build());

  • Method Details

    • getBootstrapClusterCreatorAdminPermissions

      @Stability(Stable) @Nullable default Boolean getBootstrapClusterCreatorAdminPermissions()
      Whether or not IAM principal of the cluster creator was set as a cluster admin access entry during cluster creation time.

      Changing this value after the cluster has been created will result in the cluster being replaced.

      Default: true

    • getBootstrapSelfManagedAddons

      @Stability(Stable) @Nullable default Boolean getBootstrapSelfManagedAddons()
      If you set this value to False when creating a cluster, the default networking add-ons will not be installed.

      The default networking addons include vpc-cni, coredns, and kube-proxy. Use this option when you plan to install third-party alternative add-ons or self-manage the default networking add-ons.

      Changing this value after the cluster has been created will result in the cluster being replaced.

      Default: true if the mode is not EKS Auto Mode

    • getCompute

      @Stability(Stable) @Nullable default ComputeConfig getCompute()
      Configuration for compute settings in Auto Mode.

      When enabled, EKS will automatically manage compute resources.

      Default: - Auto Mode compute disabled

    • getDefaultCapacity

      @Stability(Stable) @Nullable default Number getDefaultCapacity()
      Number of instances to allocate as an initial capacity for this cluster.

      Instance type can be configured through defaultCapacityInstanceType, which defaults to m5.large.

      Use cluster.addAutoScalingGroupCapacity to add additional customized capacity. Set this to 0 is you wish to avoid the initial capacity allocation.

      Default: 2

    • getDefaultCapacityInstance

      @Stability(Stable) @Nullable default InstanceType getDefaultCapacityInstance()
      The instance type to use for the default capacity.

      This will only be taken into account if defaultCapacity is > 0.

      Default: m5.large

    • getDefaultCapacityType

      @Stability(Stable) @Nullable default DefaultCapacityType getDefaultCapacityType()
      The default capacity type for the cluster.

      Default: AUTOMODE

    • getOutputConfigCommand

      @Stability(Stable) @Nullable default Boolean getOutputConfigCommand()
      Determines whether a CloudFormation output with the aws eks update-kubeconfig command will be synthesized.

      This command will include the cluster name and, if applicable, the ARN of the masters IAM role.

      Default: true

    • builder

      @Stability(Stable) static ClusterProps.Builder builder()
      Returns:
      a ClusterProps.Builder of ClusterProps