Gateway API v1.7.0
Release Notes
Major Themes
Graduating to Standard
- HTTPRoute Retries (GEP-1731): the
retryconfiguration of an HTTPRoute rule (codes,attemptsandbackoff) is promoted to the Standard channel, together with theHTTPRouteRetryCodesandHTTPRouteRetryConnectionErrorconformance features. Thebackofffield is implementation-specific because backoff behavior, especially jitter, varies between implementations. (#5357, @snorwin, #5359, @mikemorris)
New in Experimental
- Gateway Address Routability (GEP-5093): routability is expressed per Gateway address, so a single Gateway can serve addresses of different scopes. Valid values are empty (implementation default),
Cluster, or a domain-prefixed implementation-specific value. (#5304, @rikatz) - Standardized Attribute Dictionary (GEP-5253): a shared, vendor-neutral set of traffic attributes, based on OpenTelemetry semantic conventions, for use by features such as
XTelemetryPolicy. (#5256, @gkhom) - Session Persistence on Backend (GEP-1619 and GEP-4894): session persistence is configured on the
XBackendresource, and the route-inline andBackendTrafficPolicyattachment points are deprecated. (#4876, #5298, @gcs278) - Pre-routing Filters (GEP-5224): listener filters that run before routing decisions, for use cases such as external authentication and payload processing, with the new
GatewayListenerFiltersfeature. Filters can be set on both Gateway andListenerSetlisteners. (#5315, @jaellio, #5370, @snorwin) - ClusterTrustBundle in
caCertificateRefs(GEP-5075):BackendTLSPolicyand Gateway frontend TLS validation can reference aClusterTrustBundlethrough the existingcaCertificateRefsfield, instead of copying CA bundles into every namespace. (#5272, #5356, @davidesalerno) - TelemetryPolicy for Distributed Tracing (GEP-4768): the
XTelemetryPolicyAPI standardizes tracing configuration for Gateways without vendor-specific CRDs. Metrics and access logs are not covered yet. (#5323, @gkhom)
Major Changes Since v1.6.3
Breaking Changes
- Experimental API changes (no effect on the Standard channel):
- SessionPersistence API:
sessionNamemoved tocookie.name(Extended, optional) andheader.name(Core, required),cookieConfigrenamed tocookie, andHeaderConfigadded. (#4873, @gcs278) - SessionPersistence API: the cookie
Pathnow defaults to/instead of being computed from route matches, and the newcookie.pathfield (Extended) allows explicit path configuration. (#5046, @gcs278) - SessionPersistence: route-inline and
BackendTrafficPolicysession persistence are deprecated in favor of the Backend resource. (#4876, @gcs278) XBackend:spec.port.portwas renamed tospec.port.number,spec.port.namewas removed, andbackendRef.portis now prohibited when referencing anXBackend. (#5287, @gcs278)
- SessionPersistence API:
- Go types:
BackendAncestorStatus.AncestorRefwas renamed in the generated Go types for consistency with docs and JSON/YAML serialization. (#5187, @Stevenjin8)ForwardBodyConfig.MaxSizechanged type fromuint16toint32. (#5099, @arjunxplorer)
- Conformance features:
- Go was upgraded to 1.27 (
go 1.27.0directive ingo.modandconformance/go.mod) and Kubernetes dependencies to v0.37. (#5297, @snorwin, #5232, @snorwin, [#5388](https://github.com/kubernetes-sigs/gateway-api/pu
[truncated]