Skip to content

docs(alb): configure an ALB with the Gateway API - #173

Open
dlotterman wants to merge 1 commit into
mainfrom
docs/alb-gateway-api
Open

dlotterman wants to merge 1 commit into
mainfrom
docs/alb-gateway-api

Conversation

@dlotterman

@dlotterman dlotterman commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Datum projects serve the Kubernetes Gateway API (gateway.networking.k8s.io/v1 Gateway, HTTPRoute, BackendTLSPolicy) directly. HTTPProxy is 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:

  • the datum-external-global-proxy GatewayClass
  • a working Gateway + HTTPRoute + FQDN EndpointSlice example
  • custom-hostname listeners with certificate-issuer: auto
  • redirecting HTTP to HTTPS, which a raw Gateway doesn't do by default (unlike HTTPProxy)
  • attaching a TrafficProtectionPolicy to a Gateway
  • the validation rules network-services-operator enforces (internal/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 from alb/overview.mdx.

Verification

Tested end to end against a live project with datumctl:

  • The Gateway was Accepted and Programmed, with a generated *.datumproxy.net hostname
  • HTTPS to an httpbin.org origin returned 200
  • The redirect route on default-http returned 301 to HTTPS
  • A TPP in Enforce mode on the Gateway returned 403 for an XSS probe
  • The documented rejections (HTTPRoute.spec.hostnames, a listener without a hostname, HTTPS without TLS options) were confirmed with server-side dry runs

I 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/httproute links to, says spec.hostnames and traffic mirroring are supported. The webhook rejects both.

@dlotterman
dlotterman requested a review from a team as a code owner November 18, 2026 20:33
@mintlify

mintlify Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Datum 🟢 Ready View Preview Nov 18, 2026, 8:39 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

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.

This branch was successfully deployed

1 active deployment
staging — 0940a46f Deployed Nov 18, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants