Skip to content

Commit 5978177

Browse files
authored
update docs about multiple controller deployment (#2186)
1 parent b382a94 commit 5978177

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

docs/deploy/configurations.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,13 @@
11
# Controller configuration options
22
This document covers configuration of the AWS Load Balancer controller
33

4+
!!!warning "limitation"
5+
The v2.0.0+ version of AWSLoadBalancerController currently only support one controller deployment(with one or multiple replicas) per cluster.
6+
7+
The AWSLoadBalancerController assumes it's the solo owner of worker node security group rules with `elbv2.k8s.aws/targetGroupBinding=shared` description, running multiple controller deployment will cause these controllers compete with each other updating worker node security group rules.
8+
9+
We will remove this limitation in future versions: [tracking issue](https://github.com/kubernetes-sigs/aws-load-balancer-controller/issues/2185)
10+
411
## AWS API Access
512
To perform operations, the controller must have required IAM role capabilities for accessing and
613
provisioning ALB resources. There are many ways to achieve this, such as loading `AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY` as environment variables or using [kube2iam](https://github.com/jtblin/kube2iam).
@@ -12,7 +19,6 @@ You can limit the ingresses ALB ingress controller controls by combining followi
1219

1320
### Limiting ingress class
1421
Setting the `--ingress-class` argument constrains the controller's scope to ingresses with matching `kubernetes.io/ingress.class` annotation.
15-
This is especially helpful when running multiple ingress controllers in the same cluster. See [Using Multiple Ingress Controllers](https://github.com/nginxinc/kubernetes-ingress/tree/master/examples/multiple-ingress-controllers#using-multiple-ingress-controllers) for more details.
1622

1723
An example of the container spec portion of the controller, only listening for resources with the class "alb", would be as follows.
1824

0 commit comments

Comments
 (0)