Clarify HTTPRoute Gateway references in chart docs

Author: Bafbi

helm-chart/README.md

@@ -25,7 +25,8 @@ EOF
 helm install onyxia onyxia/onyxia --version "10.32.5" -f onyxia-values.yaml
 ```
 
-To expose Onyxia with the Kubernetes Gateway API instead of an Ingress, use an `HTTPRoute`:
+To expose Onyxia with the Kubernetes Gateway API instead of an Ingress, use an `HTTPRoute`.
+The `parentRefs` entries must point to the `Gateway` already configured by your cluster administrator:
 
 ```bash
 cat << EOF > ./onyxia-values.yaml
@@ -93,16 +94,6 @@ Documentation reference for the available configuration parameter of the Onyxia
 Below is a sample `onyxia-values.yaml` file that illustrates where to specify the `api` and `web` configuration parameters.
 
 ```diff
- ingress:
-      enabled: true
-      hosts:
-        - host: datalab.yourdomain.com
-+httpRoute:
-+    enabled: true
-+    parentRefs:
-+      - name: onyxia-gateway
-+    hostnames:
-+      - datalab.yourdomain.com
 +web:
 +    env:
 +      HEADER_LOGO=https://example.com/logo.svg
@@ -125,6 +116,27 @@ Below is a sample `onyxia-values.yaml` file that illustrates where to specify th
 +              # ...
 ```
 
+Ingress example:
+
+```yaml
+ingress:
+  enabled: true
+  hosts:
+    - host: datalab.yourdomain.com
+```
+
+HTTPRoute example:
+
+```yaml
+httpRoute:
+  enabled: true
+  parentRefs:
+    # Reference the Gateway configured by your cluster administrator.
+    - name: onyxia-gateway
+  hostnames:
+    - datalab.yourdomain.com
+```
+
 ## Catalogs `x-onyxia` specifications
 
 If you are building your own service catalog for Onyxia ([learn how](https://docs.onyxia.sh/catalog-of-services)).  

helm-chart/templates/httproute.yaml

@@ -13,8 +13,8 @@ metadata:
   name: {{ $fullName }}
   labels:
     {{- include "onyxia.labels" . | nindent 4 }}
-  annotations:
   {{- with .Values.httpRoute.annotations }}
+  annotations:
     {{- toYaml . | nindent 4 }}
   {{- end }}
 spec:

helm-chart/values.yaml

@@ -17,7 +17,9 @@ httpRoute:
   enabled: false
   annotations: {}
   parentRefs:
-    - name: ""
+    # parentRefs must reference the Gateway configured by the cluster administrator.
+    # parentRefs[0].name is required when httpRoute.enabled=true.
+    - name: onyxia-gateway
       # namespace:
       # sectionName:
       # port: