Skip to content

Conversation

@howardjohn
Copy link
Contributor

@howardjohn howardjohn commented Dec 1, 2025

Description

#13021

This is only adding the API. Implementation to follow.

The idea of the API is to primarily rely on 'overlays'. An overlay allows users to specify a metadata/spec for objects, which is an opaque map of fields that is strategic-merge-patch applied over the generated objects. This exposes every field of the underlying APIs, without requiring us to expose each API individually with a slightly different API; users can just use the Kubernetes API's as they intended.

In order to facilitate very common configuration, or configuration that benefits from being broken out. Currently, this includes logLevel, labels/annotations (to apply to ALL objects), image, etc. We should avoid creeping this too much. Likely the following are potentially in scope (copied from AGW underlying config):

|config||
|config.enableIpv6||
|config.localXdsPath|Local XDS path. If not specified, the current configuration file will be used.|
|config.caAddress||
|config.caAuthToken||
|config.xdsAddress||
|config.xdsAuthToken||
|config.namespace||
|config.gateway||
|config.trustDomain||
|config.serviceAccount||
|config.clusterId||
|config.network||
|config.adminAddr|Admin UI address in the format "ip:port"|
|config.statsAddr|Stats/metrics server address in the format "ip:port"|
|config.readinessAddr|Readiness probe server address in the format "ip:port"|
|config.connectionTerminationDeadline||
|config.connectionMinTerminationDeadline||
|config.workerThreads||
|config.metrics||
|config.metrics.remove||
|config.metrics.fields||
|config.metrics.fields.add||
|config.hbone||
|config.hbone.windowSize||
|config.hbone.connectionWindowSize||
|config.hbone.frameSize||
|config.hbone.poolMaxStreamsPerConn||
|config.hbone.poolUnusedReleaseTimeout|

We may also want a raw passthrough to AGW bootstrap config.

Change Type

/kind feature

Changelog

Added a new AgentgatewayParameters API

Additional Notes

Signed-off-by: John Howard <[email protected]>
Signed-off-by: John Howard <[email protected]>
@gateway-bot gateway-bot added kind/feature Categorizes issue or PR as related to a new feature. release-note labels Dec 1, 2025
@chandler-solo
Copy link
Contributor

I have some 'TODO' comments in #13018 that I'd like to iron out, but I enjoy this API so much that I have a first draft implementation.

chandler-solo added a commit to chandler-solo/kgateway that referenced this pull request Dec 4, 2025
@npolshakova
Copy link
Contributor

Let's close this out since #13018 merged

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/feature Categorizes issue or PR as related to a new feature. release-note

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants