feat(chart): Support topology spread constraints (#26)

Author: hibare

deployments/helm/gate/README.md

@@ -626,6 +626,7 @@ externalSecrets:
 | `nodeSelector` | Node selector for pod scheduling | `{}` |
 | `tolerations` | Tolerations for pod scheduling | `[]` |
 | `affinity` | Affinity rules (includes pod anti-affinity by default) | See values.yaml |
+| `topologySpreadConstraints` | Topology spread constraints for distributing pods across nodes/zones | `[]` |
 
 ### Service parameters
 

deployments/helm/gate/templates/deployment.yaml

@@ -181,3 +181,7 @@ spec:
       tolerations:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.topologySpreadConstraints }}
+      topologySpreadConstraints:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}

deployments/helm/gate/values.schema.json

@@ -367,6 +367,56 @@
         }
       }
     },
+    "topologySpreadConstraints": {
+      "type": "array",
+      "description": "Topology spread constraints for distributing pods across nodes/zones",
+      "items": {
+        "type": "object",
+        "properties": {
+          "maxSkew": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "topologyKey": {
+            "type": "string"
+          },
+          "whenUnsatisfiable": {
+            "type": "string",
+            "enum": [
+              "DoNotSchedule",
+              "ScheduleAnyway"
+            ]
+          },
+          "labelSelector": {
+            "type": "object"
+          },
+          "minDomains": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "matchLabelKeys": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "nodeAffinityPolicy": {
+            "type": "string",
+            "enum": [
+              "Honor",
+              "Ignore"
+            ]
+          },
+          "nodeTaintsPolicy": {
+            "type": "string",
+            "enum": [
+              "Honor",
+              "Ignore"
+            ]
+          }
+        }
+      }
+    },
     "service": {
       "type": "object",
       "description": "Kubernetes Service configuration",

deployments/helm/gate/values.yaml

@@ -143,6 +143,17 @@ tolerations: []
 
 affinity: {}
 
+# Topology spread constraints for distributing pods across nodes/zones.
+# Example (soft spread across nodes, never blocks scheduling):
+#   topologySpreadConstraints:
+#     - maxSkew: 1
+#       topologyKey: kubernetes.io/hostname
+#       whenUnsatisfiable: ScheduleAnyway
+#       labelSelector:
+#         matchLabels:
+#           app.kubernetes.io/name: gate
+topologySpreadConstraints: []
+
 # -----------------------------------------------------------------------------
 # Service configuration
 # -----------------------------------------------------------------------------