Package software.amazon.awscdk.services.eks_v2

Interface AlbControllerOptions

All Superinterfaces:
software.amazon.jsii.JsiiSerializable
All Known Subinterfaces:
AlbControllerProps
All Known Implementing Classes:
AlbControllerOptions.Jsii$Proxy, AlbControllerProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.126.0 (build 206d44b)", date="2026-02-23T18:58:18.888Z") @Stability(Stable) public interface AlbControllerOptions extends software.amazon.jsii.JsiiSerializable
Options for AlbController.

Example: 

 Cluster.Builder.create(this, "HelloEKS")
         .version(KubernetesVersion.V1_34)
         .albController(AlbControllerOptions.builder()
                 .version(AlbControllerVersion.V2_8_2)
                 .overwriteServiceAccount(true)
                 .build())
         .build();

  • Method Details

    • getVersion

      @Stability(Stable) @NotNull AlbControllerVersion getVersion()
      Version of the controller.

    • getAdditionalHelmChartValues

      @Stability(Stable) @Nullable default Map<String,Object> getAdditionalHelmChartValues()
      Additional helm chart values for ALB controller.

      For available options, see: https://github.com/kubernetes-sigs/aws-load-balancer-controller/blob/main/helm/aws-load-balancer-controller/values.yaml

      Default: - no additional helm chart values

    • getOverwriteServiceAccount

      @Stability(Stable) @Nullable default Boolean getOverwriteServiceAccount()
      Overwrite any existing ALB controller service account.

      If this is set, we will use kubectl apply instead of kubectl create when the ALB controller service account is created. Otherwise, if there is already a service account named 'aws-load-balancer-controller' in the kube-system namespace, the operation will fail.

      Default: false

    • getPolicy

      @Stability(Stable) @Nullable default Object getPolicy()
      The IAM policy to apply to the service account.

      If you're using one of the built-in versions, this is not required since CDK ships with the appropriate policies for those versions.

      However, if you are using a custom version, this is required (and validated).

      Default: - Corresponds to the predefined version.

    • getRemovalPolicy

      @Stability(Stable) @Nullable default RemovalPolicy getRemovalPolicy()
      The removal policy applied to the ALB controller resources.

      The removal policy controls what happens to the resources if they stop being managed by CloudFormation. This can happen in one of three situations:

      • The resource is removed from the template, so CloudFormation stops managing it
      • A change to the resource is made that requires it to be replaced, so CloudFormation stops managing it
      • The stack is deleted, so CloudFormation stops managing all resources in it

      Default: RemovalPolicy.DESTROY

    • getRepository

      @Stability(Stable) @Nullable default String getRepository()
      The repository to pull the controller image from.

      Note that the default repository works for most regions, but not all. If the repository is not applicable to your region, use a custom repository according to the information here: https://github.com/kubernetes-sigs/aws-load-balancer-controller/releases.

      Default: '602401143452.dkr.ecr.us-west-2.amazonaws.com/amazon/aws-load-balancer-controller'

    • builder

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