Document external Gateway (BYO Gateway) support #2184
Open
adoi wants to merge 6 commits into
Open
Conversation
Add documentation for using a user-managed Gateway with Gateway API migration, including configuration requirements, external Gateway ownership, route attachment rules, migration behavior, verification steps, and troubleshooting guidance. Signed-off-by: Adonis Murati <adonismurati@gmail.com>
…synced Signed-off-by: Adonis Murati <adonismurati@gmail.com>
Signed-off-by: Adonis Murati <adonismurati@gmail.com>
kubermatic-bot
added
do-not-merge/work-in-progress
Contributor
|
Skipping CI for Draft Pull Request. |
kubermatic-bot
added
the
size/XL
Clarify how external Gateway migrations are handled during Gateway API cleanup, including the external Gateway readiness checks, HTTPRoute Accepted requirements, and Dex skip behavior. Document the managed Gateway fallback and the kubermatic.io/gateway-route=true label contract introduced for migration readiness, so operators understand when the old managed Gateway is kept or removed. Signed-off-by: Adonis Murati <adonismurati@gmail.com>
Remove the detailed CRD version inspection command from the external Gateway requirements section and keep the main flow focused on the required user-facing behavior. Add troubleshooting guidance for switching back from a user-managed Gateway to the KKP-managed Gateway when newer Gateway API CRDs or the safe-upgrades.gateway.networking.k8s.io admission policy block applying the bundled CRDs. Signed-off-by: Adonis Murati <adonismurati@gmail.com>
kubermatic-bot
removed
the
do-not-merge/work-in-progress
Contributor
Author
|
/hold It's ready for review, I will unhold after the patches are out. |
kubermatic-bot
added
the
do-not-merge/hold
buraksekili
approved these changes
May 25, 2026
|
|
||
| Use `http://` instead of `https://` if TLS is not configured yet. | ||
|
|
||
| ### Local kind Considerations |
Contributor
There was a problem hiding this comment.
I think, we do not need to mention local-kind setup tricks on kkp docs, as this page is dedicated to product and feature in general. what do you think?
Contributor
|
LGTM label has been added. DetailsGit tree hash: cc81c00350ba1bf900c9771cac2afa2ca0b0fc11 |
Contributor
|
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: buraksekili The full list of commands accepted by this bot can be found here. The pull request process is described here DetailsNeeds approval from an approver in each of these files:
Approvers can indicate their approval by writing |
kubermatic-bot
added
the
approved
Signed-off-by: Adonis Murati <adonismurati@gmail.com>
Contributor
|
/lgtm |
Contributor
|
LGTM label has been added. DetailsGit tree hash: 74e8ae7726ee6f7d4646acefe9e4ebf1dc54bdda |
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
3 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.
Add documentation for using a user-managed Gateway with Gateway API migration, including configuration requirements, external Gateway ownership, route attachment rules, migration behavior, verification steps, and troubleshooting guidance.
xref: kubermatic/kubermatic#15862