add multi-az routing support

- add MultiAz flag to enable multi-az routing for cluster span across different zones

CRC-1963

Author: vsamidurai

api/routing/v1alpha1/envoybootstrapconfig_types.go

@@ -42,6 +42,13 @@ type EnvoyBootstrapConfigSpec struct {
 	// +kubebuilder:default=false
 	// +optional
 	ProxyProtocolEnabled bool `json:"proxyProtocolEnabled,omitempty"`
+	// MultiAZ marks this Envoy fleet as the multi-AZ load balancer. When true,
+	// the route-manager advertises this fact to Envoy via node metadata so that
+	// zone-aware routing decisions can be made per-cluster via
+	// QdrantClusterRouting.spec.multiAZ.
+	// +kubebuilder:default=false
+	// +optional
+	MultiAZ bool `json:"multiAZ,omitempty"`
 }
 
 // EnvoyBootstrapConfigStatus defines the observed state of EnvoyBootstrapConfig.

api/routing/v1alpha1/routing_types.go

@@ -59,6 +59,11 @@ type QdrantClusterRoutingSpec struct {
 	// If true enable (proxy) access log for this qdrant cluster.
 	// +optional
 	EnableAccessLog *bool `json:"enableAccessLog,omitempty"`
+	// MultiAZ is true when the Qdrant cluster spans multiple availability
+	// zones and traffic should be kept same-zone where possible.
+	// +kubebuilder:default=false
+	// +optional
+	MultiAZ bool `json:"multiAZ,omitempty"`
 }
 
 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object

charts/qdrant-kubernetes-api/templates/routing-crds/routing.qdrant.io_envoybootstrapconfigs.yaml

@@ -65,6 +65,14 @@ spec:
                   When set the Envoy runs in dedicated mode for this cluster.
                   When nil it runs in shared mode.
                 type: string
+              multiAZ:
+                default: false
+                description: |-
+                  MultiAZ marks this Envoy fleet as the multi-AZ load balancer. When true,
+                  the route-manager advertises this fact to Envoy via node metadata so that
+                  zone-aware routing decisions can be made per-cluster via
+                  QdrantClusterRouting.spec.multiAZ.
+                type: boolean
               proxyProtocolEnabled:
                 default: false
                 description: ProxyProtocolEnabled enables the PROXY protocol on Envoy

charts/qdrant-kubernetes-api/templates/routing-crds/routing.qdrant.io_qdrantclusterroutes.yaml

@@ -88,6 +88,16 @@ spec:
                   The fully qualified domain name (also know as host).
                   For shared routing this will be used for SNI resolving.
                 type: string
+              multiAZ:
+                default: false
+                description: |-
+                  MultiAZ is true when the Qdrant cluster spans multiple availability
+                  zones and traffic should be kept same-zone where possible. When true the
+                  route-manager enables zone-aware load balancing on the generated Envoy
+                  clusters so that requests prefer Qdrant pods in the same zone as the
+                  receiving Envoy pod. Defaults to false (current behaviour: flat
+                  round-robin across all zones).
+                type: boolean
               nodeIndexes:
                 description: NodeIndexes specifies the indexes of the individual nodes
                   in the cluster.

docs/api.md

@@ -1737,6 +1737,7 @@ _Appears in:_
 | --- | --- | --- | --- |
 | `clusterID` _string_ | ClusterID identifies the Qdrant cluster this Envoy instance serves.<br />When set the Envoy runs in dedicated mode for this cluster.<br />When nil it runs in shared mode. |  | Optional: \{\} <br /> |
 | `proxyProtocolEnabled` _boolean_ | ProxyProtocolEnabled enables the PROXY protocol on Envoy listeners. | false | Optional: \{\} <br /> |
+| `multiAZ` _boolean_ | MultiAZ marks this Envoy fleet as the multi-AZ load balancer. When true,<br />the route-manager advertises this fact to Envoy via node metadata so that<br />zone-aware routing decisions can be made per-cluster via<br />QdrantClusterRouting.spec.multiAZ. | false | Optional: \{\} <br /> |
 
 
 
@@ -1785,6 +1786,7 @@ _Appears in:_
 | `nodeIndexes` _integer array_ | NodeIndexes specifies the indexes of the individual nodes in the cluster. |  |  |
 | `allowedSourceRanges` _string array_ | AllowedSourceRanges specifies the allowed CIDR source ranges for the ingress. |  | Optional: \{\} <br /> |
 | `enableAccessLog` _boolean_ | If true enable (proxy) access log for this qdrant cluster. |  | Optional: \{\} <br /> |
+| `multiAZ` _boolean_ | MultiAZ is true when the Qdrant cluster spans multiple availability<br />zones and traffic should be kept same-zone where possible. When true the<br />route-manager enables zone-aware load balancing on the generated Envoy<br />clusters so that requests prefer Qdrant pods in the same zone as the<br />receiving Envoy pod. Defaults to false (current behaviour: flat<br />round-robin across all zones). | false | Optional: \{\} <br /> |