kgateway-dev/kgateway v2.2.0-beta.1

on GitHub

🎉 Welcome to the v2.2.0-beta.1 release of the kgateway project!

Installation

The kgateway project is available as a Helm chart and docker images.

Helm Charts

The Helm chart is 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.0-beta.1
• cr.kgateway.dev/kgateway-dev/sds:v2.2.0-beta.1
• cr.kgateway.dev/kgateway-dev/envoy-wrapper:v2.2.0-beta.1

Quickstart

Try installing this release:

helm install kgateway-crds oci://cr.kgateway.dev/kgateway-dev/charts/kgateway-crds --version v2.2.0-beta.1 --namespace kgateway-system --create-namespace
helm install kgateway oci://cr.kgateway.dev/kgateway-dev/charts/kgateway --version v2.2.0-beta.1 --namespace kgateway-system --create-namespace

For detailed installation instructions and next steps, please visit our quickstart guide.

Changelog

Changes from kgateway-dev/kgateway between v2.2.0-alpha.1 and v2.2.0-beta.1

Breaking Changes

• Introduces a new setting KGW_ENABLE_GATEWAY_API_EXPERIMENTAL_FEATURES to gate experimental Gateway API features and APIs. Defaults to false (#12695)
• Added new AgentgatewayPolicy to replace TrafficPolicy for agentgateway. Added support for backend and frontend configuration. (#12723)
• Remove AI policy from TrafficPolicy. (#12901)

New Features

• Allows users to define GatewayClasses using any controller. E.g., a user can create a custom GatewayClass with an arbitrary name that uses controllerName kgateway.dev/agentgateway to duplicate the behavior of the built-in GatewayClass agentgateway. A user may still choose to patch the built-in GatewayClass to change its behavior via GatewayParameters, but now it is also possible to choose to just create a new GatewayClass that refers to equivalent GatewayParameters. One motivation: two different teams that want different GatewayParameters for class agentgateway. Another motivation: clean GitOps with entirely new resources, no patching required. (#12733)
• Added event reporting for agentgateway gateways that indicates when a gateway has nacked an update (#12770)
• Added JWT Authentication configuration to the TrafficPolicy and support for JWT Providers to the GatewayExtension. (#12811)
• Add support for Azure OpenAI backends with agentgateway. (#12836)
• rustformation: implemented remove headers and some jinja custom functions (#12848)
• Introduced support for remote jwks in JWTAuthentication policies. (#12850)
• Added support for OpenAI Responses API and Anthropic token counting route types. Added prompt caching configuration for Bedrock enabling up to 90% cost reduction and significantly faster response times. (#12855)
• Introduce support for basic auth, api-key auth, and inline jwt auth policies to agent gateway (#12886)
• Add support for multiple certificateRefs in listener tls section (#12895)
• support TLS termination for TCPRoutes (#12906)

Bug Fixes

• Fix a bug where agw did not work with listenersets allowed by the namespace selector (#12838)
• Clear stale HTTPRoute status after the route has all invalid ParentRefs (#12852)
• Fixed mcp authorization parsing for backend policy on AgentgatewayPolicy. (#12897)
• fix: set default alpn on transport socket
  Allow configuring ALPN protocols using kgateway.dev/alpn-protocols TLS option
  (#12903)
• Fix a bug where a listener on a listenerset can not read a secret in its own namespace (#12936)

Cleanup

• Support for InferencePool with the kgateway class, which was deprecated in v2.1, has been removed. Support is available with the agentgateway class. (#12689)
• rustformations module reorganization, doc and build improvement (#12764)
• Use the TransformationPolicy API directly as rustformation config (#12803)
• Removes the deprecated spec.kube.aiExtension from the GatewayParameters API. Users should migrate to using the agentgateway dataplane for AI capabilities. (#12840)
• Adds TCPRoute && TLSRoute to the list of gated experimental gateway API features.
  Enable experimental gateway API features by default.
  (#12881)
• Inference: Moves InferencePool status code to agentgateway package. (#12902)