Gateway API v1.6.0
Release Notes
v1.6.0
Changes Since v1.5.1
GEP & API Graduation
- UDPRoute & TCPRoute Graduation:
- UDPRoute has graduated to GA. We recommend using the "v1" API version with this API now. The "v1alpha2" version of this API is deprecated and will be removed in the future. (#4923, @zac-nixon)
- TCPRoute has graduated to GA. We recommend using the "v1" API version with this API now. The "v1alpha2" version of this API is deprecated and will be removed in the future. (#4920, @zac-nixon)
- GEP Status Updates:
- Add GEP for the
XBackendresource into Experimental status (#4488, @keithmattix) - Move TCPRoute GEP to Standard (#4783, @zac-nixon)
- Move UDPRoute GEP to Standard (#5030, @rikatz)
- Add GEP for the
Feature
- API & Validation Enhancements:
- API validation updated for HTTPRoute retries:
retry.codesmust now be unique andretry.attemptsmust be >= 1. (#4907, @snorwin) - Increase the number of allowed Certificate Authority references from
8to16. (#4088, @root30) - The TLSRoute CRD validation has been adjusted to allow up to 1024 hostnames and rules per TLSRoute resource. Operators must validate kube-apiserver, etcd and Gateway controller behavior with representative manifests prior to enabling the new limit in production. (#4332, @alexanderstephan)
- BackendTLSPolicy now can be used in combination with other routes types. (#4745, @rikatz)
- Allow the usage of up to 16 annotations on the gateway infrastructure object. (#4707, @wenisman)
- API validation updated for HTTPRoute retries:
- Conformance Infrastructure:
- Added conformance tests for UDPRoute (GEP-2645), a new GATEWAY-UDP conformance profile, a SupportTCPRoute feature, and a UDP/TCP echo server in echo-basic gated on UDP_ECHO_SERVER. (#4861, @zac-nixon)
- Remove the
idleTimeoutfield from the experimental SessionPersistence API. (#4771, @gcs278)
Documentation
- Migration & Site Updates:
- Migrate documentation from MkDocs to Docsy. (#4734, @iromanycheva-eng)
- The new wizard should be available at https://gateway-api.sigs.k8s.io/wizard. (#4584, @bexxmodd)
- API Specs & Guidance Clarifications:
- Add missing apidoc for BackendTLSPolicy extended support. (#4828, @rikatz)
- Add the missing
ListenersNotValidprogrammed reason for listenerSets. (#4586, @davidjumani) - Added documentation guidance recommending GRPCRoute for gRPC traffic. (#4513, @kahirokunn)
- Clarified CORS API documentation to describe behavior based on
allowCredentialsinstead of credentialed requests. (#4663, @snorwin) - Previously, implementations were required to reject GRPCRoute and HTTPRoutes on the same hostname (however, few implementations did this). Now, implementations may optionally do this, or allow them to coincide. (#4598, @howardjohn)
- Updates the documentation around the ListenerConditionConflicted condition. (#4659, @davidjumani)
- Fixes:
- Grammar fix in docs for concepts/use cases. (#4798, @jkburges)
Bug or Regression
- IPv6 Support:
- Fix
GatewayFrontendClientCertificateValidationInsecureFallback,GatewayFrontendClientCertificateValidation, andGatewayFrontendInvalidDefaultClientCertificateValidationfailing on IPv6 clusters. (#4636, @zirain) - Fix
GatewayFrontendInvalidDefaultClientCertificateValidationfailing on IPv6 clusters. (#4629, @zirain)
- Fix
- ValidatingAdmissionPolicy (VAP) Fixes:
- Fixed an issue where the ValidatingAdmissionPolicy prevented experimental CRDs from being installed at all (instead of only when standard CRDs already exist). (#4603, @howardjohn)
- Fixed the safe-upgrades ValidatingAdmissionPolicy to allow upgrades of experimental CRDs. (#4557, @snorwin)
- CRD & Schema Validation:
- Generated Gateway API CRD install manifests no longer include top-level CustomResourceDefinition status fields with invalid null values, fixing strict schema validation failures in tools such as kubeconform. (#4712, @MatteoFari)
- Replace
omitemptywithomitzeroforsupportedKindsin ListenerStatus to preserve backward compatibility for controllers reconciling older Gateway API versions. (#4551, @snorwin)
- API & Validation Fixes:
- It is disallowed to have repeated
filtersoftypeCORS. (#4639, @DamianSawicki) - Limit HTTPRouteHTTPSListenerDetectMisdirectedRequests to h2 only. (#4665, @zirain)
- Make explicit call about resource names requiring to be RFC 1035 compliant. (#4787, @rikatz)
- Make
referencegrant.specfield required. (#4845, @bexxmodd)
- It is disallowed to have repeated
Test & Conformance
- New Conformance Tests:
- Add conformance test
ListenerSetAllowedRoutesCrossNamespacewhich verifies that a ListenerSet only allows routes in its own namespace by default. (#4841, @asauber) - Added a conformance test covering the Gateway
Acceptedcondition with reasonListenersNotValidand the ListenerAcceptedcondition with reasonUnsupportedProtocol. (#4807, @snorwin) - Added conformance test
GatewayInvalidParametersRefthat verifies a Gateway referencing an invalid parameters is rejected. (#4808, @snorwin) - Conformance: add ListenerSet tests for Route parentRef cases. (#4912, @asauber)
- Add conformance test
- Test Machinery & Framework Updates:
- Conformance:
ExpectMirroredRequestnow starts its log window before the requests are sent, so mirrors are not missed on high-latency data planes. (#4952, @lexfrei) - The default polling interval for conformance tests has been decreased. This can be modified by the new
DefaultPollInterval. (#4570, @howardjohn) - The gRPC conformance request helper no longer closes a caller-supplied (injected)
Options.GRPCClient; it closes only theDefaultClientit creates internally. This lets implementations reuse a custom gRPC client across requests. (#4953, @lexfrei)
- Conformance:
- **Updates & Fixes to
[truncated]