From 1a41fe098d9503c3c1f5839569bfe7a3d986214d Mon Sep 17 00:00:00 2001 From: Yu Bingjiao Date: Tue, 8 Aug 2023 00:45:09 +0800 Subject: [PATCH] Doc: Add note for rename behavior of IngressGroup (#3283) * Add warning for rename behavior of IngressGroup * Change wording per suggestion from code review * Apply grammar suggestions from code review Co-authored-by: John Gardiner Myers --------- Co-authored-by: John Gardiner Myers --- docs/guide/ingress/annotations.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/guide/ingress/annotations.md b/docs/guide/ingress/annotations.md index 2ec721084..43cf1cc6b 100644 --- a/docs/guide/ingress/annotations.md +++ b/docs/guide/ingress/annotations.md @@ -79,6 +79,13 @@ By default, Ingresses don't belong to any IngressGroup, and we treat it as a "im other Kubernetes users may create/modify their Ingresses to belong to the same IngressGroup, and can thus add more rules or overwrite existing rules with higher priority to the ALB for your Ingress. We'll add more fine-grained access-control in future versions. + + !!!note "Rename behavior" + The ALB for an IngressGroup is found by searching for an AWS tag `ingress.k8s.aws/stack` tag with the name of the IngressGroup as its value. For an implicit IngressGroup, the value is `namespace/ingressname`. + + When the groupName of an IngressGroup for an Ingress is changed, the Ingress will be moved to a new IngressGroup and be supported by the ALB for the new IngressGroup. If the ALB for the new IngressGroup doesn't exist, a new ALB will be created. + + If an IngressGroup no longer contains any Ingresses, the ALB for that IngressGroup will be deleted and any deletion protection of that ALB will be ignored. !!!example ```