Controller matching wizard by bexxmodd · Pull Request #4584 · kubernetes-sigs/gateway-api

bexxmodd · 2026-02-23T04:09:48Z

What type of PR is this?
/kind documentation

What this PR does / why we need it:
It's a controller matching wizard for the providers that submitted conformance reports. This should simplify operator/controller selection compared to peeking at the table's features.

You can run this by and test it locally at (http://localhost:8080/index.html):

make serve

Probably many things will require adjustment before this can be hosted, but it's good enough to try it locally for the initial feedback.

Which issue(s) this PR fixes:
Fixes #

Does this PR introduce a user-facing change?:

The new wizard should be available at https://gateway-api.sigs.k8s.io/wizard

k8s-ci-robot · 2026-02-23T04:09:56Z

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: bexxmodd
Once this PR has been reviewed and has the lgtm label, please assign robscott for approval. For more information see the Code Review Process.

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

Details

Needs approval from an approver in each of these files:

OWNERS

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

xtineskim · 2026-02-25T16:33:44Z

🔥 🌟
this is great! I'm glad that the data from the table is being put to good use :)
I think the wording of Good to Have and Want to have could be a bit confusing, maybe something firmer, like Must have and Preferred?

nits/nice to have (non blocker)

a way to select the version
gateway api logo on the page somewhere? (lol) or a way to show the main menu? I know this may be tricky the way that this page is spun up/use of wasm 🤔

xtineskim · 2026-02-25T19:52:18Z

hack/mkdocs-generate-controller-wizard-data.py

+# Feature definitions for the wizard: id and label match v1.4 conformance table columns
+# https://gateway-api.sigs.k8s.io/implementations/v1.4/
+FEATURE_DEFINITIONS = {
+    "httpGateway": [


more of a todo: will be worth getting the ids and labels generated rather than hard coded

Idk exactly how to do it. Feature names are not as descriptive in reports, so hard coded for later parsing.

Feel free to propose something

might be able to just get the label from the id, adding a space between the words. But this is not a blocker, so can be done in a later pr 👍

xtineskim · 2026-02-25T20:08:54Z

hack/mkdocs-generate-controller-wizard-data.py

+for the Controller Recommendation Wizard. Supports --all (one object keyed by version) or
+--version vX.Y.Z (single array for that version). Output path defaults to
+site-src/wizard/data/controller-wizard-data.json. The output directory is created if it does not exist.
+"""


so the version that lives on the website will be probably the most recent version? the version flag will have to be manually set to generate the json file - maybe we should make grabbing the version more automated? 🤔 this can be done manually for now

Just updated the mkdocs. So on each run, a new version will be grabbed, and the data will be generated for the latest three versions

robscott

Thanks @bexxmodd!

robscott · 2026-02-25T21:19:55Z

site-src/wizard/controller-wizard.html

+    <p id="version-row">
+      <label for="version-select"><strong>Gateway API version:</strong></label>
+      <select id="version-select"></select>
+    </p>


Can we make this a "min version" instead of ==

Version selection allows us to cleanly filter features and conformance reports. It's a redesign of how recommendation functions (including the data generation script) if users select min version instead of a specific one.

site-src/wizard/controller-wizard.html

…te/wizard

Co-authored-by: Rob Scott <rob.scott87@gmail.com>

bexxmodd · 2026-02-26T02:43:08Z

🔥 🌟 this is great! I'm glad that the data from the table is being put to good use :) I think the wording of Good to Have and Want to have could be a bit confusing, maybe something firmer, like Must have and Preferred?

nits/nice to have (non blocker)

a way to select the version

gateway api logo on the page somewhere? (lol) or a way to show the main menu? I know this may be tricky the way that this page is spun up/use of wasm 🤔

At the top wizard should have a drop-down menu for the latest three versions.
made it part of the docs, so it reuses the header and table list of the general page.

…med recommend to match.

wasm/main.go

howardjohn · 2026-02-26T22:27:29Z

wasm/main.go

+		return
+	}
+
+	must, good := getSelections()


We may want to consider the deployment of the gateway. For example, if I am on AWS I cannot use GKE so its a bad recommendation. Likewise, if I don't want to pay a vendor I may need an open source implementation,

While I see the potential usefulness of this, I think we want to limit the inputs to what's in conformance reports. Given the relatively small proportion of implementations from Cloud Providers, I'd expect this to be pretty easy to filter out/manually ignore when looking at the results.

Have to agree with Rob. That seems a good evolution of the wizard, but that will require tying that information to conformance, as those reports serve source of truth for what the wizard shows

bexxmodd added 7 commits February 11, 2026 11:10

Add script to verify release artifacts.

bfef290

Add \n

da3be24

Add data extraction script and html for wizard.

481b107

Remove extra file.

cf0c1ff

Added wizard content.

e720253

Added hook to wizard data generation.

4d4b405

Removed redundant data json.

e69859e

bexxmodd requested review from robscott and xtineskim February 23, 2026 04:09

k8s-ci-robot added release-note Denotes a PR that will be considered when it comes time to generate release notes. kind/documentation Categorizes issue or PR as related to documentation. labels Feb 23, 2026

k8s-ci-robot requested review from candita and rikatz February 23, 2026 04:09

k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Feb 23, 2026

k8s-ci-robot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Feb 23, 2026

bexxmodd and others added 5 commits February 23, 2026 22:00

Convert wizard into an wasm app.

4a4e9e3

Remove data json file.

0def4ac

Exclude wasm from linter.

41bac1c

Merge branch 'kubernetes-sigs:main' into site/wizard

4ec5b8c

Limit versions to the latest three and rename Want to have -> Must have

e485333

xtineskim reviewed Feb 25, 2026

View reviewed changes

robscott reviewed Feb 25, 2026

View reviewed changes

bexxmodd and others added 5 commits February 25, 2026 13:58

Merge branch 'site/wizard' of github.com:bexxmodd/gateway-api into si…

fc49230

…te/wizard

Update site-src/wizard/controller-wizard.html

a6c70b6

Co-authored-by: Rob Scott <rob.scott87@gmail.com>

Good to have -> Nice to have

1a50e3d

host wizard on k8s page.

ddec234

Changed header and wording and update linter run to exclude wasm folder.

306f9dc

css adjustments to fit mkdocs.

b1cd66b

bexxmodd changed the title ~~[Draft] Controller recommendation wizard~~ Controller recommendation wizard Feb 26, 2026

bexxmodd added 4 commits February 25, 2026 19:43

typo for border.

3daacb0

Trying to pass golinter.

512ea15

removed misplaced build directive.

1e0f8d2

Add boilerplate to go files.

23330f9

bexxmodd changed the title ~~Controller recommendation wizard~~ Controller matching wizard Feb 26, 2026

bexxmodd added 8 commits February 26, 2026 09:00

Make adjustments to the wizard: added descriptions, subheadings, rena…

6046ef7

…med recommend to match.

Go lint update.

4975b45

Improve embedding of wizard into mkdocs.

d4438e7

css adjustments.

f5691d1

move feature groups around.

4056b8f

reset grpcecho.pd.go

57b2421

space

ada61cd

Another space

785100e

howardjohn reviewed Feb 26, 2026

View reviewed changes

bexxmodd added 5 commits February 27, 2026 09:59

Added random tiebreaker.

4da6fd9

Replace math/rand with math/rand/v2

b6e6814

Updated UI to improve UX.

b79b39d

changed wording of intro paragraph.

bd4f9f8

Prevent nested scroll bar from appearing.

51a777f

bexxmodd mentioned this pull request Mar 3, 2026

Instrument Gateway API's webpage with GA4 #4626

Open

Nest backendTLS in HTTPRoute.

8a2b0ea

Conversation

bexxmodd commented Feb 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

k8s-ci-robot commented Feb 23, 2026

Uh oh!

xtineskim commented Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

robscott left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

bexxmodd Feb 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

bexxmodd commented Feb 26, 2026

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

bexxmodd commented Feb 23, 2026 •

edited

Loading

xtineskim commented Feb 25, 2026 •

edited

Loading

bexxmodd Feb 25, 2026 •

edited

Loading