Merge pull request #4196 from andreybutenko/2025-05-22-eks-auto-mode

Add EKS Auto Mode considerations to documentation

Author: zac-nixon

docs/guide/ingress/annotations.md

@@ -14,6 +14,12 @@ You can add annotations to kubernetes Ingress and Service objects to customize t
         - Merge: such annotation can be specified on all Ingresses within IngressGroup, and will be merged together.
 
 ## Annotations
+
+!!!question "EKS Auto Mode users"
+    If you are using EKS Auto Mode, please see the
+    [EKS Auto Mode documentation](https://docs.aws.amazon.com/eks/latest/userguide/auto-configure-alb.html#_considerations)
+    for key differences between the load balancing capability of EKS Auto Mode and the open source load balancer controller.
+
 | Name                                                                                                  | Type                                               |Default| Location        | MergeBehavior |
 |-------------------------------------------------------------------------------------------------------|----------------------------------------------------|------|-----------------|---------------|
 | [alb.ingress.kubernetes.io/load-balancer-name](#load-balancer-name)                                   | string                                             |N/A| Ingress         | Exclusive     |

docs/guide/ingress/ingress_class.md

@@ -53,6 +53,12 @@ the name of the Ingress controller.
     You can enforce IngressClass resource adoption by disabling the `kubernetes.io/ingress.class` annotation via [--disable-ingress-class-annotation](../../../deploy/configurations/#disable-ingress-class-annotation) controller flag.
 
 ## IngressClassParams
+
+!!!question "EKS Auto Mode users"
+    If you are using EKS Auto Mode, please see the
+    [EKS Auto Mode documentation](https://docs.aws.amazon.com/eks/latest/userguide/auto-configure-alb.html#_considerations)
+    for key differences between the load balancing capability of EKS Auto Mode and the open source load balancer controller.
+
 IngressClassParams is a [CRD](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/) specific to the AWS Load Balancer Controller, which can be used along with IngressClass’s parameter field.
 You can use IngressClassParams to enforce settings for a set of Ingresses.
 

docs/guide/service/annotations.md

@@ -13,6 +13,11 @@
     These annotations are specific to the kubernetes [service resources reconciled](#lb-type) by the AWS Load Balancer Controller. Although the list was initially derived from the k8s in-tree `kube-controller-manager`, this
     documentation is not an accurate reference for the services reconciled by the in-tree controller. 
 
+!!!question "EKS Auto Mode users"
+    If you are using EKS Auto Mode, please see the
+    [EKS Auto Mode documentation](https://docs.aws.amazon.com/eks/latest/userguide/auto-configure-nlb.html#_considerations)
+    for key differences between the load balancing capability of EKS Auto Mode and the open source load balancer controller.
+
 | Name                                                                                                                 | Type                    | Default                  | Notes                                                                                                                                                                                                                                                                                                                                                                                                                |
 |----------------------------------------------------------------------------------------------------------------------|-------------------------|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | [service.beta.kubernetes.io/load-balancer-source-ranges](#lb-source-ranges)                                          | stringList              |                          |                                                                                                                                                                                                                                                                                                                                                                                                                      |

docs/guide/targetgroupbinding/spec.md

@@ -1,3 +1,8 @@
+!!!question "EKS Auto Mode users"
+    If you are using EKS Auto Mode, please see the
+    [EKS Auto Mode documentation](https://docs.aws.amazon.com/eks/latest/userguide/auto-configure-alb.html#_considerations)
+    for key differences between the load balancing capability of EKS Auto Mode and the open source load balancer controller.
+
 <p>Packages:</p>
 <ul>
 <li>

docs/guide/targetgroupbinding/targetgroupbinding.md

@@ -9,6 +9,10 @@ This will allow you to provision the load balancer infrastructure completely out
 
     You can view all TargetGroupBindings in a namespace by `kubectl get targetgroupbindings -n <your-namespace> -o wide`
 
+!!!question "EKS Auto Mode users"
+    If you are using EKS Auto Mode, please see the
+    [EKS Auto Mode documentation](https://docs.aws.amazon.com/eks/latest/userguide/auto-configure-alb.html#_considerations)
+    for key differences between the load balancing capability of EKS Auto Mode and the open source load balancer controller.
 
 ## TargetType
 TargetGroupBinding CR supports TargetGroups of either `instance` or `ip` TargetType.