[Automated] Update reference docs (main) from agentgateway main - #1009
Merged
Conversation
…s, and agctl CLI docs from agentgateway main Signed-off-by: GitHub Action <action@github.com>
Deploying agentproxy with
|
| Latest commit: |
9cd798a
|
| Status: | ⚡️ Build in progress... |
…g import default Follows the reference doc updates in this PR with the prose that the generated reference implies. All three changes are gated to the version that `main` points at, because none of them exist in 1.5.x or earlier. - Session affinity (Kubernetes): the `sessionAffinity` backend policy is new to the Kubernetes API, on both `AgentgatewayBackend.spec.policies` and `AgentgatewayPolicy.spec.backend`. Standalone already documented it in 1.5, but the Kubernetes tree had no coverage at all. Adds a section to the shared load-balancing page, including the CRD rule that the policy must target the whole backend rather than one AI provider. - Access log preset: `preset` selects the OTel-aligned built-in HTTP field set for stdout access logs. Documented for both modes, with the field rename table taken from telemetry/semconv.rs. Note the casing differs by mode: `Otel` in Kubernetes, `otel` in standalone. - Catalog import default: `agctl catalog import --source` now defaults to `github`, the curated catalog published at agentgateway.dev/model-catalog, not models.dev. Corrects the two places that stated the old default and drops a now-misleading `--source models.dev` from an example. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Signed-off-by: Kristin Brown <kristin.brown@solo.io>
Signed-off-by: Kristin Brown <kristin.brown@solo.io>
Vale.Spelling flags bare `XBackend` in prose. The file already puts resource and command names in code spans inside headings, such as "The `MODEL_CATALOG_PATHS` environment variable is removed", so follow that. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Signed-off-by: Kristin Brown <kristin.brown@solo.io>
Adds the prose page behind the 1.6 XBackend release note, which until now pointed only at the Helm value. The page lives in the main tree only, because the feature arrives in 1.6. Documents what the controller actually reads, taken from controller/pkg/syncer/backend/xbackend.go rather than from the field descriptions: - `spec.type` must be `ExternalHostname`. That is not an agentgateway limitation: it is the only type Gateway API v1.6.1 defines. - The protocol mapping, including that `H2C` with a TLS mode other than `None` is rejected, and that `MCP` produces a single streamable HTTP target in stateful mode. - The TLS rules: only `System` for `wellKnownCACertificates`, core ConfigMaps with a `ca.crt` key for `caCertificateRefs`, and a `ReferenceGrant` for a cross-namespace `clientCertificateRef`. - A route's `port` is ignored, because resolveXBackend discards the port parameter and the port comes from `spec.port.port`. - An AgentgatewayPolicy can target an XBackend by targetRefs or targetSelectors, which is how you add what the resource cannot express. Uses the helm-agentgateway/helm-path/patch-dev snippets rather than a hardcoded chart URL, and the experimental install path, since XBackend needs the experimental-channel custom resources. Not covered by a doc test: the page is `test: skip`, because verifying it needs a cluster with the experimental CRDs and the feature gate on. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Signed-off-by: Kristin Brown <kristin.brown@solo.io>
Signed-off-by: Kristin Brown <kristin.brown@solo.io>
Signed-off-by: Kristin Brown <kristin.brown@solo.io>
kristin-kronstain-brown
approved these changes
Sep 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Generate reference documentation for agentgateway (main).
Source: agentgateway/agentgateway at
main.Updates API reference (including shared types such as CEL expression) and interactive kubespec widgets, Helm (agentgateway + agentgateway-crds for Kubernetes mode, agentgateway-standalone for standalone mode), control plane metrics, and the agctl CLI reference for the main version.
This PR was created automatically by the reference-docs workflow.
Workflow run: https://github.com/agentgateway/website/actions/runs/33723261151