Skip to content

Commit 7e75d7b

Browse files
committed
docs(ingress): add section for frontend NLB attributes
1 parent fa19a3c commit 7e75d7b

File tree

1 file changed

+27
-0
lines changed

1 file changed

+27
-0
lines changed

docs/guide/ingress/annotations.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1356,3 +1356,30 @@ When this option is set to true, the controller will automatically provision a N
13561356
```
13571357
alb.ingress.kubernetes.io/frontend-nlb-eip-allocations: eipalloc-xyz, eipalloc-zzz
13581358
```
1359+
1360+
- <a name="frontend-nlb-attributes">`alb.ingress.kubernetes.io/frontend-nlb-attributes`</a> specifies [Load Balancer Attributes](http://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_LoadBalancerAttribute.html) that should be applied to the ALB.
1361+
1362+
!!!warning ""
1363+
Only attributes defined in the annotation will be updated. To unset any AWS defaults(e.g. Disabling access logs after having them enabled once), the values need to be explicitly set to the original values(`access_logs.s3.enabled=false`) and omitting them is not sufficient.
1364+
1365+
!!!note ""
1366+
- If `deletion_protection.enabled=true` is in annotation, the controller will not be able to delete the ALB during reconciliation. Once the attribute gets edited to `deletion_protection.enabled=false` during reconciliation, the deployer will force delete the resource.
1367+
- Please note, if the deletion protection is not enabled via annotation (e.g. via AWS console), the controller still deletes the underlying resource.
1368+
1369+
!!!example
1370+
- enable access log to s3
1371+
```
1372+
service.beta.kubernetes.io/aws-load-balancer-attributes: access_logs.s3.enabled=true,access_logs.s3.bucket=my-access-log-bucket,access_logs.s3.prefix=my-app
1373+
```
1374+
- enable NLB deletion protection
1375+
```
1376+
service.beta.kubernetes.io/aws-load-balancer-attributes: deletion_protection.enabled=true
1377+
```
1378+
- enable cross zone load balancing
1379+
```
1380+
service.beta.kubernetes.io/aws-load-balancer-attributes: load_balancing.cross_zone.enabled=true
1381+
```
1382+
- enable client availability zone affinity
1383+
```
1384+
service.beta.kubernetes.io/aws-load-balancer-attributes: dns_record.client_routing_policy=availability_zone_affinity
1385+
```

0 commit comments

Comments
 (0)