Skip to content

Commit d6655b0

Browse files
committed
docs(ingress): add section for frontend NLB attributes
1 parent d1f7d83 commit d6655b0

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
@@ -1222,3 +1222,30 @@ When this option is set to true, the controller will automatically provision a N
12221222
```
12231223
alb.ingress.kubernetes.io/frontend-nlb-eip-allocation: eipalloc-xyz, eipalloc-zzz
12241224
```
1225+
1226+
- <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.
1227+
1228+
!!!warning ""
1229+
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.
1230+
1231+
!!!note ""
1232+
- 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.
1233+
- Please note, if the deletion protection is not enabled via annotation (e.g. via AWS console), the controller still deletes the underlying resource.
1234+
1235+
!!!example
1236+
- enable access log to s3
1237+
```
1238+
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
1239+
```
1240+
- enable NLB deletion protection
1241+
```
1242+
service.beta.kubernetes.io/aws-load-balancer-attributes: deletion_protection.enabled=true
1243+
```
1244+
- enable cross zone load balancing
1245+
```
1246+
service.beta.kubernetes.io/aws-load-balancer-attributes: load_balancing.cross_zone.enabled=true
1247+
```
1248+
- enable client availability zone affinity
1249+
```
1250+
service.beta.kubernetes.io/aws-load-balancer-attributes: dns_record.client_routing_policy=availability_zone_affinity
1251+
```

0 commit comments

Comments
 (0)