Repository navigation
Commit 2d3e481
committed
design-proposal(endpoint-attachments): bind a Service or an HTTPRoute; gateway synthesizes TLSRoute/TCPRoute
Reframe the gateway member around what the app ships. The attachment binds
one of two app-shipped artifacts — a Service (the L4, sufficient contract,
first-class now) or the app's own HTTPRoute (the L7 case, carrying path
topology). TLSRoute and TCPRoute are never bind targets: the controller
synthesizes them from a Service, because an app gains nothing by shipping a
route whose only inputs are the backend and an SNI hostname. The synthesized
passthrough TLSRoute is #20's per-release data plane.
- L7 multi-route consistency: an app that must know its hostname declares it
in its spec, templating a consistent HTTPRoute-set; the attachment binds the
set, not individual routes, constrained to the hostnames they declare, so it
can never split frontend and backend across hosts.
- Discovery by lineage label extends to route objects (webhook labels them;
it never creates or places routes). Listeners/Gateways/GatewayClasses stay
admin-owned outside the app. Binding leans on the experimental Gateway-API
listener-selects-route capability. Flux/Argo SSA per-field ownership makes
controller-written labels safe under GitOps.
- endpoint gains routeName beside serviceName (gateway L7 case).
- Non-goal: gateway-routing VMs and tenant-ordered LoadBalancers (VMs stay on
the loadBalancer / attach-public-IP path; kubevirt territory).
- ClickHouse cited as the worked case for discovery-by-label over a chart
exposure field (operator-owned ClusterIP Service, no external key, no route).
Open questions added, flagged not resolved: dedicated controller vs chart
helpers (lexfrei's objection recorded, no alternative on the table yet); the
experimental route->listener reference direction; routes-in-charts up front vs
gradually; and the gatewayRef->exposure-class rename, still held on the class
name. Carries the 10-18 drop-path edits (no L7 routing, no path).
Signed-off-by: Timofei Larkin <[email protected]>1 parent e768b7c commit 2d3e481
1 file changed
Lines changed: 32 additions & 15 deletions
0 commit comments