Skip to content

Conversation

@snorwin
Copy link
Member

@snorwin snorwin commented Oct 22, 2025

What type of PR is this?

/kind documentation
/kind feature

What this PR does / why we need it:
This PR follows up on #4123 to update the GoDoc comments and introduce a new GatewayConditionType constant of ResolvedRefs, with associated Reason as its own GatewayConditionReason.

Which issue(s) this PR fixes:

N/A

Does this PR introduce a user-facing change?:

Add experimental ResolvedRefs condition for Gateway

@k8s-ci-robot k8s-ci-robot added release-note Denotes a PR that will be considered when it comes time to generate release notes. kind/documentation Categorizes issue or PR as related to documentation. kind/feature Categorizes issue or PR as related to a new feature. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Oct 22, 2025
@k8s-ci-robot k8s-ci-robot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Oct 22, 2025
@snorwin
Copy link
Member Author

snorwin commented Oct 22, 2025

/cc @kl52752 @rikatz

Signed-off-by: Norwin Schnyder <norwin.schnyder+github@gmail.com>
@snorwin snorwin force-pushed the gateway-backend-tls-api branch from 11ba606 to bc1e880 Compare October 23, 2025 06:36
@youngnick
Copy link
Contributor

Nice work, thanks @snorwin.

/approve

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: snorwin, youngnick

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Nov 6, 2025
@snorwin snorwin force-pushed the gateway-backend-tls-api branch 2 times, most recently from 4856b7f to 0818f34 Compare November 8, 2025 08:46
Signed-off-by: Norwin Schnyder <norwin.schnyder+github@gmail.com>
@snorwin snorwin force-pushed the gateway-backend-tls-api branch from 0818f34 to 425d501 Compare November 8, 2025 09:06
// * It refers to a resource that cannot be resolved (e.g., the referenced resource
// does not exist) or is misconfigured (e.g., a Secret does not contain the keys
// named `tls.crt` and `tls.key`). In this case, the `ResolvedRefs` condition
// on the Gateway MUST be set to False with the Reason `InvalidClientCertificateRef`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm worried that Cx might confused this error with other TLS based features like ClientCertValidation, can we be more specifica about the certificate?
InvalidClientCertificateRef -> InvalidGatewayClientCertificateRef

Copy link
Member Author

@snorwin snorwin Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wouldn't InvalidBackendClientCertificateRef be more accurate?

However, it is quite long, and since a Gateway only has one clientCertificateRef field, it should be clear which one is meant.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

InvalidBackendClientCertificateRef is not accurate because this is Gateway's certificate to communicate with Backends.


// This reason is used with the "ResolvedRefs" condition when one or more
// Listeners have their "ResolvedRefs" condition set to false in their status.
GatewayReasonListenersNotResolved GatewayConditionReason = "ListenersNotResolved"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it will be useful to specify what should be overall Gateway Status when References are not resolved. If if is already defined please point me to the docs.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What are you referring to as the overall Gateway status, the Accepted status condition?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it might be tricky since the setting is on Gateway but its usage depends on BackendTLSPolicy so maybe it should not impact Accepted condition but it is worth to define that.

Copy link
Member Author

@snorwin snorwin Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point, I had implicitly assumed that the ResolvedRefs condition wouldn’t affect acceptance (this was the main reason for introducing a new condition). I’ll make this explicit and add a short description.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. kind/documentation Categorizes issue or PR as related to documentation. kind/feature Categorizes issue or PR as related to a new feature. release-note Denotes a PR that will be considered when it comes time to generate release notes. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants