feat(CLI): add a check requiring the gateway API#15409
Merged
Merged
Conversation
Signed-off-by: Alex Leong <alex@buoyant.io>
Signed-off-by: Alex Leong <alex@buoyant.io>
Signed-off-by: Alex Leong <alex@buoyant.io>
Signed-off-by: Alex Leong <alex@buoyant.io>
Signed-off-by: Alex Leong <alex@buoyant.io>
alpeb
approved these changes
Jul 7, 2026
| []Checker{ | ||
| { | ||
| description: "Gateway API CRDs are installed", | ||
| hintAnchor: "l5d-existence-crd", |
Member
There was a problem hiding this comment.
I think we should use a different anchor so the troubleshooting docs can speak more specifically about the gateway api.
Signed-off-by: Alex Leong <alex@buoyant.io>
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.
When Linkerd is installed with the CLI, we first check to ensure the Gateway API CRDs are installed, and abort if the Gateway API is not present. However, if Helm is used to the install Linkerd, no such check is performed. This can lead to an invalid installation because HTTPRoute is a required CRD for Linkerd.
We add a check to
linkerd checkthat validates that the Gateway API is installed.But note the prior art in: #12917
In that PR we removed a check for the Gateway API. This is because the Gateway API consists of many different CRDs, most of which are optional for Linkerd; only HTTPRoute is required. Therefore, we don't want to require that all Gateway API CRDs are installed. For this new check, the HTTPRoute CRD alone is sufficient to make it pass. This matches the behavior of the condition checked by the
linkerd installcommand.