Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarity on GRPCRoute: Extended vs. Core support #3659

Open
aharbis opened this issue Mar 5, 2025 · 1 comment
Open

Clarity on GRPCRoute: Extended vs. Core support #3659

aharbis opened this issue Mar 5, 2025 · 1 comment
Labels
kind/documentation Categorizes issue or PR as related to documentation. needs-triage Indicates an issue or PR lacks a `triage/foo` label and requires one.

Comments

@aharbis
Copy link

aharbis commented Mar 5, 2025

What would you like to be added:

I'd like to see clarifying details regarding if the GRPCRoute resource as a whole is Core vs. Extended, and if it's the latter, how that impacts individual fields having Core support.

Perhaps this is not unique to GRPCRoute, but it's a notable example. If there's a more central place (like the Conformance page) to explain this nuance, that works too.

Why this is needed:

It's not clear where GRPCRoute falls regarding conformance profiles. The API reference for GRPCRoute states (emphasis mine):

GRPCRoute falls under extended support within the Gateway API. Within the following specification, the word “MUST” indicates that an implementation supporting GRPCRoute must conform to the indicated requirement, but an implementation not supporting this route type need not follow the requirement unless explicitly indicated.

Yet, within the resource's reference individual fields (such as hostnames within GRPCRouteSpec) state Core:

Support: Core

So, it's unclear to me: is GRPCRoute under extended support, or core?

@aharbis aharbis added the kind/documentation Categorizes issue or PR as related to documentation. label Mar 5, 2025
@xtineskim
Copy link
Contributor

Hi @aharbis, thanks for suggesting this
I agree, we can make it more clear what the difference between core and extended in the docs. To clarify, the above is saying that all implementations don't have to provide a GRPCRoute, however if they do, then their GRPCRouteSpec must be present.

@shaneutt shaneutt added the needs-triage Indicates an issue or PR lacks a `triage/foo` label and requires one. label Mar 10, 2025
@shaneutt shaneutt moved this to Triage in Gateway API Pipeline Mar 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/documentation Categorizes issue or PR as related to documentation. needs-triage Indicates an issue or PR lacks a `triage/foo` label and requires one.
Projects
Status: Triage
Development

No branches or pull requests

3 participants