sadpandajoe commented on code in PR #43635:
URL: https://github.com/apache/superset/pull/43635#discussion_r3901622867
##########
docs/admin_docs/installation/kubernetes.mdx:
##########
@@ -319,6 +320,50 @@ configOverrides:
AUTH_USER_REGISTRATION_ROLE = "Admin"
```
+### Exposing Superset via Gateway API (HTTPRoute)
+
+As an alternative to `Ingress`, the chart can create a [Gateway
API](https://gateway-api.sigs.k8s.io/)
+`HTTPRoute` that attaches to a Gateway already running in your cluster. This
requires the Gateway
+API CRDs (`gateway.networking.k8s.io/v1`) to be installed, along with a
Gateway resource for the
+route to attach to. If the Gateway lives in a different namespace than the
`HTTPRoute` (as in the
+example below), its listener's `allowedRoutes` must explicitly permit routes
from this release's
+namespace, or the `HTTPRoute` will install successfully but never attach.
+
+```yaml
+httproute:
+ enabled: true
+ parentRefs:
+ - name: my-gateway
+ namespace: gateway-system
+ hostnames:
+ - superset.example.com
+ rules:
+ - matches:
+ - path:
+ type: PathPrefix
+ value: /
+```
+
+- `httproute.parentRefs` lists the Gateway(s) the route attaches to.
+- `httproute.hostnames` matches against the HTTP `Host` header; it's
templated, so values like
+ `{{ .Release.Name }}` can be used.
+- `httproute.rules` are routing rules backed by the Superset service; each
rule accepts standard
+ `matches`, `filters`, and `timeouts` fields, and an optional `weight`
(defaults to `1`) applied to
+ its single backend reference. Since each rule maps to one backend, `weight`
has no traffic-splitting
+ effect here; it only matters if you fork the template to add multiple
`backendRefs` to a rule.
+ `timeouts` only joined the Gateway API Standard channel in v1.2, so it
requires a v1.2+ Gateway
Review Comment:
A v1.2+ controller alone does not guarantee that this field exists in the
installed CRDs, so clusters with pre-v1.2 CRDs reject a copied timeout. Could
this say that `timeouts` requires Gateway API v1.2+ CRDs as well as a
supporting controller?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
