Repository navigation
docs(alb): configure an ALB with the Gateway API - #173
Open
dlotterman wants to merge 1 commit into
Open
dlotterman wants to merge 1 commit into
dlotterman wants to merge 1 commit into
Conversation
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
dlotterman
force-pushed
the
docs/alb-gateway-api
branch
from
November 18, 2026 20:36
901f852 to
d11842b
Compare
Projects serve gateway.networking.k8s.io/v1 Gateway and HTTPRoute directly; HTTPProxy is a layer on top. Add a page covering the datum-external-global-proxy GatewayClass, a working Gateway + HTTPRoute + EndpointSlice example, custom hostnames, HTTP->HTTPS redirect, WAF attachment, and the validation rules the operator enforces. Examples verified end to end against a live project.
dlotterman
force-pushed
the
docs/alb-gateway-api
branch
from
November 18, 2026 20:39
5174465 to
0940a46
Compare
scotwells
approved these changes
Nov 18, 2026
This branch was successfully deployed
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
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.
Summary
Datum projects serve the Kubernetes Gateway API (
gateway.networking.k8s.io/v1Gateway, HTTPRoute, BackendTLSPolicy) directly.HTTPProxyis a layer on top of it that generates a Gateway and an HTTPRoute with the same name. Until now the docs only described the Gateway as something the operator creates for you.This adds
alb/configuration/gateway-api.mdx, which covers:datum-external-global-proxyGatewayClasscertificate-issuer: autoTrafficProtectionPolicyto a Gatewayinternal/validation/gateway_validation.go,httproute_validation.go)It also adds the page to the Configuration group in
docs.json, a row in the Configuration overview table, and a link fromalb/overview.mdx.Verification
Tested end to end against a live project with
datumctl:*.datumproxy.nethostnamehttpbin.orgorigin returned 200default-httpreturned 301 to HTTPSHTTPRoute.spec.hostnames, a listener without a hostname, HTTPS without TLS options) were confirmed with server-side dry runsI didn't run Vale or a Mintlify preview locally.
Follow-up
The operator's HTTPRoute skill (
network-services-operator/claude-plugin/skills/httproute/SKILL.md), which/agents/skills/httproutelinks to, saysspec.hostnamesand traffic mirroring are supported. The webhook rejects both.