Skip to content

Commit 2d3e481

Browse files
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

File tree

  • design-proposals/endpoint-attachments

0 commit comments

Comments
 (0)