docs: recommend ListenerSet over mergeGateways#9524
Open
zhaohuabing wants to merge 2 commits into
Open
Conversation
✅ Deploy Preview for cerulean-figolla-1f9435 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
zhaohuabing
force-pushed
the
docs-recommend-listenerset
branch
from
July 19, 2026 10:12
f1061a8 to
03c3513
Compare
The mergeGateways feature was introduced before the Gateway API supported ListenerSet. ListenerSet is the Gateway API-native mechanism for splitting listeners across resources: it removes the single-Gateway 64-listener limit and enables a delegated management model suitable for high-scale, multi-tenant environments. Add recommendation alerts to the deployment-mode docs pointing users to ListenerSet, linking the upstream user guide and issue envoyproxy#1230. Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>
zhaohuabing
force-pushed
the
docs-recommend-listenerset
branch
from
July 19, 2026 10:16
03c3513 to
05ceef7
Compare
arkodg
previously approved these changes
Jul 20, 2026
Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This PR updates the deployment-mode docs to recommend
ListenerSetovermergeGatewaysfor new deployments, adding recommendation alerts that link to the upstream ListenerSet user guide and to #1230.Background
The
mergeGatewaysfeature was introduced before the Gateway API supported ListenerSet.ListenerSetis the Gateway API-native way to split listener configuration across resources: teams define ports, hostnames, and TLS certificates in separate resources rather than cramming everything into one giant Gateway object (which is limited to 64 listeners). This enables a delegated management model suitable for high-scale, multi-tenant environments.