From 1b3c1504b2d97baf443fa9d06642f427422ebc39 Mon Sep 17 00:00:00 2001 From: Benjamin Chastanier Date: Fri, 5 Jun 2026 16:33:41 +0200 Subject: [PATCH] chore(QOV-1968): envoy control plane replace HPA with fix replicas QOV-1968 --- .../cluster-advanced-settings.mdx | 48 +++---------------- 1 file changed, 6 insertions(+), 42 deletions(-) diff --git a/docs/configuration/cluster-advanced-settings.mdx b/docs/configuration/cluster-advanced-settings.mdx index f9097a1..171aa3f 100644 --- a/docs/configuration/cluster-advanced-settings.mdx +++ b/docs/configuration/cluster-advanced-settings.mdx @@ -1207,57 +1207,21 @@ Notes: --- - + -### envoy.gateway.hpa.cpu_average_utilization_percentage_threshold - -**Cloud Provider:** AWS Scaleway GCP Azure - -**Type:** `float` - -**Description:** HPA CPU average utilization threshold for the Envoy Gateway control-plane deployment, expressed as a value between 0.0 and 1.0 (e.g., 0.8 for 80%). When CPU usage exceeds this threshold, Kubernetes scales the `envoy-gateway` controller deployment. This setting applies to the Gateway Helm chart HPA for the control plane. - -**Valid values:** `0.0` to `1.0` - -**Default Value:** `null` (uses Kubernetes default behavior) - - - -### envoy.gateway.hpa.memory_average_utilization_percentage_threshold - -**Cloud Provider:** AWS Scaleway GCP Azure - -**Type:** `float` - -**Description:** HPA memory average utilization threshold for the Envoy Gateway control-plane deployment, expressed as a value between 0.0 and 1.0 (e.g., 0.8 for 80%). When memory usage exceeds this threshold, Kubernetes scales the `envoy-gateway` controller deployment. This setting applies to the Gateway Helm chart HPA for the control plane. - -**Valid values:** `0.0` to `1.0` - -**Default Value:** `null` (uses Kubernetes default behavior) - - - -### envoy.gateway.hpa.min_number_instances +### envoy.gateway_controller.replicas **Cloud Provider:** AWS Scaleway GCP Azure **Type:** `integer` -**Description:** Minimum number of Envoy Gateway control-plane replicas for horizontal pod autoscaling. This ensures baseline controller availability for reconciliation and configuration updates. Must be less than or equal to `envoy.gateway.hpa.max_number_instances`. +**Description:** Number of Envoy Gateway controller replicas for the control-plane deployment. This is a fixed replica count, not an HPA setting. Use it to control controller availability for reconciliation and configuration updates. -**Default Value:** `2` for production clusters, `1` for non-production clusters +The Envoy Gateway controller is a control-plane component that watches Gateway API and Envoy Gateway resources and produces configuration for Envoy Proxy, rather than serving live traffic itself. In practice, adding replicas is mainly about controller availability and recovery if a pod crashes, not about spreading request workload across controller instances. See the [Envoy Gateway introduction](https://gateway.envoyproxy.io/docs/concepts/introduction/) and the [leader election settings](https://gateway.envoyproxy.io/docs/api/extension_types/#leaderelection), which are enabled by default for Kubernetes providers. - +**Valid values:** integer greater than or equal to `1` -### envoy.gateway.hpa.max_number_instances - -**Cloud Provider:** AWS Scaleway GCP Azure - -**Type:** `integer` - -**Description:** Maximum number of Envoy Gateway control-plane replicas for horizontal pod autoscaling. This sets an upper limit on controller scaling and resource consumption. Must be greater than or equal to `envoy.gateway.hpa.min_number_instances`. - -**Default Value:** `5` +**Default Value:** `2` for production clusters, `1` for non-production clusters ---