Update Gateway API related documentation for clarity and deactivate it by default

Author: TheophileDiot

README.md

@@ -19,6 +19,7 @@ Official [Helm chart](https://helm.sh/docs/) to deploy [BunkerWeb](https://www.b
 - Kubernetes 1.19+
 - Helm 3.8+
 - PV provisioner support in the underlying infrastructure (for persistence)
+- Kubernetes Gateway API CRDs installed (required for Gateway API support, see the [Gateway API install guide](https://gateway-api.sigs.k8s.io/guides/getting-started/#installing-gateway-api))
 
 **Important**: Please first refer to the [BunkerWeb documentation](https://docs.bunkerweb.io/latest/?utm_campaign=self&utm_source=github), particularly the [Kubernetes integration](https://docs.bunkerweb.io/latest/integrations/?utm_campaign=self&utm_source=bunkerwebio#kubernetes) section.
 
@@ -80,6 +81,8 @@ settings:
 
 ### Kubernetes Integration
 
+**Controller selection**: The controller runs as either a `GatewayController` or an `IngressController`, never both. If both are configured, `GatewayController` takes priority.
+
 ```yaml
 settings:
   kubernetes:
@@ -262,4 +265,4 @@ See [`examples/`](examples/) directory for complete configuration examples.
 
 ## License
 
-This Helm chart is licensed under the same terms as BunkerWeb itself.
+This Helm chart is licensed under the same terms as BunkerWeb itself.

charts/bunkerweb/values.yaml

@@ -1329,7 +1329,8 @@ redis:
 
 gatewayClass:
   # Create GatewayClass resource
-  enabled: true
+  # Requires Kubernetes Gateway API CRDs to be installed in the cluster: https://gateway-api.sigs.k8s.io/guides/getting-started/#installing-gateway-api
+  enabled: false
 
   # GatewayClass name (used in gateway resources)
   name: "bunkerweb"

docs/values.md

@@ -368,6 +368,8 @@ Manages BunkerWeb configuration and coordination
 ## controller
 
 Kubernetes controller for automatic Ingress management
+The controller runs as either a `GatewayController` or an `IngressController`, never both. If both are configured, `GatewayController` takes priority.
+Gateway API support requires Kubernetes Gateway API CRDs to be installed in the cluster. See the [Gateway API install guide](https://gateway-api.sigs.k8s.io/guides/getting-started/#installing-gateway-api).
 
 | Parameter | Description | Type | Default |
 |-----------|-------------|------|---------|
@@ -693,4 +695,3 @@ Configuration for BunkerWeb behavior in Kubernetes environment
 | `settings.ui.ingress.tlsSecretName` | Secret name containing TLS certificate Leave empty to disable HTTPS | `string` | `""` |
 
 ---
-