Skip to content

Commit 1c0caff

Browse files
committed
clarify listener name semantics
1 parent e138110 commit 1c0caff

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

geps/gep-1713/index.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -466,8 +466,11 @@ spec:
466466

467467
### Listener Validation
468468

469-
Implementations MUST treat the parent `Gateway`s as having the merged list of all listeners from itself and attached `ListenerSets`. See 'Listener Precedence' for more details on ordering.
470-
Validation of this list of listeners MUST behave the same as if the list were part of a single `Gateway`.
469+
Within a single resource such as a `Gateway` or `ListenerSet` the list of listeners MUST have unique names. Implementations MUST allow listeners from a child `ListenerSet` to be merged into a parent `Gateway` when listeners have the same name. Likewise implementations MUST allow sibling `ListenerSets` listeners with matching names to be merged into a parent `Gateway`. This allows for authors of Routes to simply attach to their desired parentRef and listener without having to worry about naming conflicts across resources.
470+
471+
Implementations MUST treat the parent `Gateway`s as having the merged list of all listeners from itself and attached `ListenerSets` and validation of this list of listeners MUST behave the same as if the list were part of a single `Gateway` with the relaxed listener name constraints.
472+
473+
Ordering will follow the semantics defined in [Listener Precedence](#listener-precedence).
471474

472475
From the earlier example the above resources would be equivalent to a single `Gateway` where the listeners are collapsed into a single list.
473476

0 commit comments

Comments
 (0)