Skip to content

docs: add Kgateway BBR documentation#1908

Merged
k8s-ci-robot merged 1 commit intokubernetes-sigs:mainfrom
howardjohn:docs/kgw-bbr
Nov 26, 2025
Merged

docs: add Kgateway BBR documentation#1908
k8s-ci-robot merged 1 commit intokubernetes-sigs:mainfrom
howardjohn:docs/kgw-bbr

Conversation

@howardjohn
Copy link
Copy Markdown
Contributor

What type of PR is this?

/kind documentation

What this PR does / why we need it:
This adds documentation for performing BBR with Kgateway. Kgateway is listed on the getting started (https://gateway-api-inference-extension.sigs.k8s.io/guides/#__tabbed_2_3) but not on the BBR (https://gateway-api-inference-extension.sigs.k8s.io/guides/serve-multiple-genai-models) docs.

Which issue(s) this PR fixes:

Fixes #

Does this PR introduce a user-facing change?:

NONE

@k8s-ci-robot k8s-ci-robot added kind/documentation Categorizes issue or PR as related to documentation. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Nov 26, 2025
@k8s-ci-robot k8s-ci-robot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Nov 26, 2025
@netlify
Copy link
Copy Markdown

netlify Bot commented Nov 26, 2025

Deploy Preview for gateway-api-inference-extension ready!

Name Link
🔨 Latest commit 9af2306
🔍 Latest deploy log https://app.netlify.com/projects/gateway-api-inference-extension/deploys/6927634588b5630007f791e7
😎 Deploy Preview https://deploy-preview-1908--gateway-api-inference-extension.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@howardjohn
Copy link
Copy Markdown
Contributor Author

cc @danehans


=== "Kgateway"

Kgateway does not require the Body-Based Routing Extension, and instead natively implements Body-Based Routing.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@howardjohn thanks for the PR.
we’re currently in the process of extending BBR to more than just extracting the model from the body to a header.
more details in #1812.

is it possible to add to kgateway support to invoke additional ext proc (before epp) as it is with the other gateways?

current PR is very tailored to the current BBR but that will get outdated very quickly.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nirrozenbaum kgateway can do ext_proc but we believe its best to do processing natively. We can do what is described in #1812 natively as well and am happy to update the docs with examples once it lands.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we believe its best to do processing natively

I agree with you here 100%. there is a different (not directly related) effort to standardize exactly this as part of k8s AI-Gateway WG, and ideally after we standardize it we should replace the existing ext proc based bbr with native one. but that’s a different story.

+1 on proceeding and take the “fix it forward” approach.

/lgtm
/approve

Thanks! 🙏🏼

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Nov 26, 2025
@k8s-ci-robot
Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: howardjohn, nirrozenbaum

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Nov 26, 2025
@k8s-ci-robot k8s-ci-robot merged commit 337eb69 into kubernetes-sigs:main Nov 26, 2025
11 checks passed
elevran pushed a commit to elevran/gateway-api-inference-extension that referenced this pull request Nov 27, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. kind/documentation Categorizes issue or PR as related to documentation. lgtm "Looks good to me", indicates that a PR is ready to be merged. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants