🎉 Welcome to the v2.3.0-beta.1 release of the kgateway project!
Release Notes
Changes since v2.2.0-beta.6
Breaking Changes
- Agentgateway ExtAuth policies will now fail closed when the backendRef to the auth server is invalid (#13258)
New Features
- Add RequestID configuration to ListenerPolicy and HTTPListenerPolicy for controlling Envoy's UUID request ID behavior (#13240)
- Envoy data plane configuration via GatewayParameters now allows for strategic-merge-patch (overlays). This includes new envoy data plane support for PodDisruptionBudget, HorizontalPodAutoscaler, and VerticalPodAutoscaler. (#13266)
- Expose
filterEnabledandfilterEnforcedconfiguration in TrafficPolicy LocalRateLimitPolicy. This allows users to control the percentage of requests for which the rate limit filter is enabled or enforced, useful for testing and gradual rollouts. ``` (#13272) - Allow skipping controller Service creation via
.controller.service.enabled: false.
Allow full configurability for controller Services.
(#13274) - Both controllers' helm charts support HorizontalPodAutoscaler and VerticalPodAutoscaler (#13276)
- Added support for GRPCRoute attached policy. (#13293)
- Support GCP backends to route traffic to Google Cloud Platform services, such as Google Cloud Run (#13308)
- Support loadBalancerClass in envoy proxy service (#13328)
- Add support for priorityClassName to kgateway and agentgateway helm charts. (#13341)
- Add support for commonLabels in kgateway and agentgateway helm charts. (#13342)
- Default
udp_max_queriesto 100, and allow customizing it using GatewayParameters. (#13348) - kgateway oauth2 policy: allow disabling set-cookie response
header for token cookies.
(#13383)
Bug Fixes
- Fixed the ancestor ref on AgentgatewayPolicy to resolve to Gateway. (#13281)
- For agentgateway controller, correctly merge and handle status from other controllers (#13316)
- (chore): use native go instead of curl pod to create http reqs by 1shubham7 (#13323)
- always add auto host rewrite to gcp route action (#13421)
- fix: AgentgatewayParameters did not merge resources or Istio configuration deeply when present on both GC and GW (#13468)
Deprecations
- Removed obsolete agentgateway configuration API from envoy-only GatewayParameters. (#13102)
Documentation
- Updates API docs regarding server-side apply (SSA) and AgentgatewayParameters (#13300)
Cleanup
- updated to use envoy 1.36.4; prep for multi-arch build (#13242)
- Enable krtequals linter checkUnexported option and fix all violations to ensure Equals() methods compare all relevant fields (#13275)
- Migrate inference pool plugin to use upstream EPP metadata constants from gateway-api-inference-extension package (#13280)
- [rustformation] create per config minijinja env (#13289)
- switch to rustformation by default (#13307)
- Helm charts are now published with both v-prefixed and non-prefixed version
tags (e.g., v2.1.0 and 2.1.0) for compatibility with SemVer-strict GitOps
tools.
(#13372)
Contributors
Thanks to all the contributors who made this release possible:
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.
- cr.agentgateway.dev/charts/agentgateway.
Docker Images
The docker images are available at:
- cr.kgateway.dev/kgateway-dev/kgateway:v2.3.0-beta.1
- cr.kgateway.dev/kgateway-dev/sds:v2.3.0-beta.1
- cr.kgateway.dev/kgateway-dev/envoy-wrapper:v2.3.0-beta.1
- cr.agentgateway.dev/agentgateway-controller:v2.3.0-beta.1
Quickstart
Try installing this release:
helm install kgateway-crds oci://cr.kgateway.dev/kgateway-dev/charts/kgateway-crds --version v2.3.0-beta.1 --namespace kgateway-system --create-namespace
helm install kgateway oci://cr.kgateway.dev/kgateway-dev/charts/kgateway --version v2.3.0-beta.1 --namespace kgateway-system --create-namespace
helm install agentgateway-crds oci://cr.agentgateway.dev/charts/agentgateway-crds --version v2.3.0-beta.1 --namespace agentgateway-system --create-namespace
helm install agentgateway oci://cr.agentgateway.dev/charts/agentgateway --version v2.3.0-beta.1 --namespace agentgateway-system --create-namespace
For detailed installation instructions and next steps, please visit our quickstart guide.




















