Skip to content

Commit a3986fe

Browse files
Update documentation for AWS ELB
Add more details on the mechanics of security group annotations as incorrect use could potentially cause an outage.
1 parent d353fcf commit a3986fe

File tree

1 file changed

+10
-3
lines changed
  • content/en/docs/concepts/services-networking

1 file changed

+10
-3
lines changed

content/en/docs/concepts/services-networking/service.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -906,11 +906,18 @@ There are other annotations to manage Classic Elastic Load Balancers that are de
906906
# value. Defaults to 5, must be between 2 and 60
907907

908908
service.beta.kubernetes.io/aws-load-balancer-security-groups: "sg-53fae93f"
909-
# A list of existing security groups to be added to ELB created. Unlike the annotation
910-
# service.beta.kubernetes.io/aws-load-balancer-extra-security-groups, this replaces all other security groups previously assigned to the ELB.
909+
# A list of existing security groups to be configured on the ELB created. Unlike the annotation
910+
# service.beta.kubernetes.io/aws-load-balancer-extra-security-groups, this replaces all other security groups previously assigned to the ELB and also overrides the creation
911+
# of a uniquely generated security group for this ELB.
912+
# The first security group ID on this list is used as a source to permit incoming traffic to target worker nodes (service traffic and health checks).
913+
# If multiple ELBs are configured with the same security group ID, only a single permit line will be added to the worker node security groups, that means if you delete any
914+
# of those ELBs it will remove the single permit line and block access for all ELBs that shared the same security group ID.
915+
# This can cause a cross-service outage if not used properly
911916

912917
service.beta.kubernetes.io/aws-load-balancer-extra-security-groups: "sg-53fae93f,sg-42efd82e"
913-
# A list of additional security groups to be added to the ELB
918+
# A list of additional security groups to be added to the created ELB, this leaves the uniquely generated security group in place, this ensures that every ELB
919+
# has a unique security group ID and a matching permit line to allow traffic to the target worker nodes (service traffic and health checks).
920+
# Security groups defined here can be shared between services.
914921

915922
service.beta.kubernetes.io/aws-load-balancer-target-node-labels: "ingress-gw,gw-name=public-api"
916923
# A comma separated list of key-value pairs which are used

0 commit comments

Comments
 (0)