🎉 Welcome to the v2.2.4 release of the kgateway project!
Release Notes
Changes since v2.2.3
Breaking Changes
- Gateway API version compatibility improvements that will break installations using unsupported Gateway API versions. Introduces environment variable KGW_SKIP_GATEWAY_API_VERSION_CHECK to allow users to use unsupported versions. (#13872)
Bug Fixes
- Publishes helm charts only after the docker images they reference are published. (#13900)
- Fix stale routing when no endpoints are available by emitting an explicit empty ClusterLoadAssignment so Envoy returns 503 instead of routing to a stale pod IP.
Fix a reconnect-time xDS race where Envoy could briefly receive routes and listeners before all referenced backend clusters were present, causing transient NC/500 responses during controller restart.
(#13947)
Dependency Updates
- Dependency updates. (#13930)
Installation
The kgateway project is available as a Helm chart and docker images.
Helm Charts
The Helm charts are available at:
- cr.kgateway.dev/kgateway-dev/charts/kgateway.
Docker Images
The docker images are available at:
- cr.kgateway.dev/kgateway-dev/kgateway:v2.2.4
- cr.kgateway.dev/kgateway-dev/sds:v2.2.4
- cr.kgateway.dev/kgateway-dev/envoy-wrapper:v2.2.4
Quickstart
Try installing this release:
helm install kgateway-crds oci://cr.kgateway.dev/kgateway-dev/charts/kgateway-crds --version v2.2.4 --namespace kgateway-system --create-namespace
helm install kgateway oci://cr.kgateway.dev/kgateway-dev/charts/kgateway --version v2.2.4 --namespace kgateway-system --create-namespace
For detailed installation instructions and next steps, please visit our quickstart guide.