feat: GatewayClass agentgateway-v2, controllerName agentgateway.dev/agentgateway (#13088)

Signed-off-by: David L. Chandler <[email protected]>
Signed-off-by: Joshua Pritchard <[email protected]>
Co-authored-by: Joshua Pritchard <[email protected]>

Author: chandler-solo

AGENTS.md

@@ -8,7 +8,7 @@ kgateway is a **dual control plane** implementing the Kubernetes Gateway API for
 ### Controller Names & Isolation
 kgateway supports **two independent controllers** that can run side-by-side:
 - **Envoy Controller**: `kgateway.dev/kgateway` (defined in `wellknown.DefaultGatewayControllerName`)
-- **Agentgateway Controller**: `kgateway.dev/agentgateway` (defined in `wellknown.DefaultAgwControllerName`)
+- **Agentgateway Controller**: `agentgateway.dev/agentgateway` (defined in `wellknown.DefaultAgwControllerName`)
 
 **Critical Requirements:**
 1. Controllers MUST always respect `GatewayClass.spec.controllerName` Classname can matter, in the case of waypoints, but its always more specific information
@@ -34,7 +34,7 @@ kgateway supports **two independent controllers** that can run side-by-side:
 **Deployment:**
 - Gateway reconciler checks enable flags before calling deployer
 - Deployer selects chart based on Gateway's controllerName from GatewayClass
-- Chart selection: envoy chart for `kgateway.dev/kgateway`, agentgateway chart for `kgateway.dev/agentgateway`
+- Chart selection: envoy chart for `kgateway.dev/kgateway`, agentgateway chart for `agentgateway.dev/agentgateway`
 
 **Enable Flags:**
 - `EnableEnvoy` (default: true): Controls if envoy ProxySyncer, StatusSyncer, and GatewayClass creation run

Makefile

@@ -853,7 +853,7 @@ conformance-%:  ## Run only the specified Gateway API conformance test by ShortN
 #----------------------------------------------------------------------------------
 
 # Agent Gateway conformance test configuration
-AGW_CONFORMANCE_GATEWAY_CLASS ?= agentgateway
+AGW_CONFORMANCE_GATEWAY_CLASS ?= agentgateway-v2
 AGW_CONFORMANCE_REPORT_ARGS ?= -report-output=$(TEST_ASSET_DIR)/conformance/agw-$(VERSION)-report.yaml -organization=kgateway-dev -project=kgateway -version=$(VERSION) -url=github.com/kgateway-dev/kgateway -contact=github.com/kgateway-dev/kgateway/issues/new/choose
 AGW_CONFORMANCE_ARGS := -gateway-class=$(AGW_CONFORMANCE_GATEWAY_CLASS) $(AGW_CONFORMANCE_REPORT_ARGS)
 

api/v1alpha1/kgateway/gateway_parameters_types.go

@@ -83,7 +83,7 @@ type KubernetesProxyConfig struct {
 	Deployment *ProxyDeployment `json:"deployment,omitempty"`
 
 	// Configuration for the container running Envoy.
-	// If the Gateway uses a GatewayClass with controllerName: kgateway.dev/agentgateway,
+	// If the Gateway uses a GatewayClass with controllerName: agentgateway.dev/agentgateway,
 	// the EnvoyContainer values will be ignored.
 	//
 	// +optional
@@ -679,7 +679,7 @@ func (in *StatsMatcher) GetExclusionList() []shared.StringMatcher {
 
 // Agentgateway configures the agentgateway dataplane integration.
 // The agentgateway dataplane is automatically used when the Gateway references a GatewayClass
-// with controllerName: kgateway.dev/agentgateway.
+// with controllerName: agentgateway.dev/agentgateway.
 type Agentgateway struct {
 	// Log level for the agentgateway. Defaults to info.
 	// Levels include "trace", "debug", "info", "error", "warn". See: https://docs.rs/tracing/latest/tracing/struct.Level.html

examples/ai-backend-with-routes.yaml

@@ -3,7 +3,7 @@ kind: Gateway
 metadata:
   name: ai-gateway
 spec:
-  gatewayClassName: agentgateway
+  gatewayClassName: agentgateway-v2
   listeners:
   - name: http
     port: 8080

examples/ai-bedrock-with-prompt-caching.yaml

@@ -3,7 +3,7 @@ kind: Gateway
 metadata:
   name: ai-gateway
 spec:
-  gatewayClassName: agentgateway
+  gatewayClassName: agentgateway-v2
   listeners:
   - name: http
     port: 8080

install/helm/kgateway-crds/templates/gateway.kgateway.dev_gatewayparameters.yaml

@@ -648,7 +648,7 @@ spec:
                   envoyContainer:
                     description: |-
                       Configuration for the container running Envoy.
-                      If the Gateway uses a GatewayClass with controllerName: kgateway.dev/agentgateway,
+                      If the Gateway uses a GatewayClass with controllerName: agentgateway.dev/agentgateway,
                       the EnvoyContainer values will be ignored.
                     properties:
                       bootstrap:

pkg/agentgateway/plugins/testdata/backendpolicy/ai.yaml

@@ -158,4 +158,4 @@ status:
       reason: Attached
       status: "True"
       type: Attached
-    controllerName: kgateway.dev/agentgateway
+    controllerName: agentgateway.dev/agentgateway

pkg/agentgateway/plugins/testdata/backendpolicy/mcp-authz-gateway.yaml

@@ -71,4 +71,4 @@ status:
       reason: Attached
       status: "True"
       type: Attached
-    controllerName: kgateway.dev/agentgateway
+    controllerName: agentgateway.dev/agentgateway

pkg/agentgateway/plugins/testdata/backendpolicy/mcp-authz-route.yaml

@@ -71,4 +71,4 @@ status:
       reason: Attached
       status: "True"
       type: Attached
-    controllerName: kgateway.dev/agentgateway
+    controllerName: agentgateway.dev/agentgateway

pkg/agentgateway/plugins/testdata/backendpolicy/simple.yaml

@@ -96,4 +96,4 @@ status:
       reason: PartiallyValid
       status: "True"
       type: Accepted
-    controllerName: kgateway.dev/agentgateway
+    controllerName: agentgateway.dev/agentgateway