fix(chart): support CPU-only relay autoscaling

deploy/charts/buzz/Chart.yaml

@@ -7,7 +7,7 @@ description: |
   PostgreSQL and Redis. Configurable for single-node evaluation
   (subcharts on) and HA production (external services, existingSecret).
 type: application
-version: 0.1.4
+version: 0.1.5
 appVersion: "0.1.0"
 home: https://github.com/block/buzz
 sources:
@@ -23,8 +23,8 @@ maintainers:
     url: https://github.com/block
 annotations:
   artifacthub.io/changes: |
-    - kind: added
-      description: Optional CPU and per-pod WebSocket horizontal autoscaling for relay pods.
+    - kind: changed
+      description: Allow CPU-only relay autoscaling when no custom-metrics adapter is installed.
   artifacthub.io/license: Apache-2.0
 
 # Optional eval-only subcharts. Production deploys disable both and point

deploy/charts/buzz/README.md

@@ -89,16 +89,18 @@ autoscaling:
   minReplicas: 5
   maxReplicas: 15
   targetCPUUtilizationPercentage: 65
+  websocketMetricEnabled: true
   websocketMetricName: buzz_ws_connections_active
   targetWebsocketConnections: 5000
 ```
 
-CPU scaling requires Kubernetes Metrics Server. WebSocket scaling additionally
-requires a custom-metrics adapter (for example Prometheus Adapter) configured to
-expose the relay's `buzz_ws_connections_active` gauge as a pod metric with the
-name in `websocketMetricName`. The chart creates the HPA but deliberately does
-not install or configure a cluster-wide metrics adapter. Scale-down is gradual
-by default so long-lived WebSocket connections have time to drain.
+CPU scaling requires Kubernetes Metrics Server. Set `websocketMetricEnabled: false`
+for a CPU-only HPA. WebSocket scaling additionally requires a custom-metrics
+adapter (for example Prometheus Adapter) configured to expose the relay's
+`buzz_ws_connections_active` gauge as a pod metric with the name in
+`websocketMetricName`. The chart creates the HPA but deliberately does not
+install or configure a cluster-wide metrics adapter. Scale-down is gradual by
+default so long-lived WebSocket connections have time to drain.
 
 ## Upgrades
 

deploy/charts/buzz/templates/_validate.tpl

@@ -41,8 +41,8 @@ surface at template time regardless of which manifest helm renders first.
   {{- if lt (.Values.autoscaling.maxReplicas | int) (.Values.autoscaling.minReplicas | int) -}}
     {{- fail "autoscaling.maxReplicas must be greater than or equal to autoscaling.minReplicas" -}}
   {{- end -}}
-  {{- if not .Values.autoscaling.websocketMetricName -}}
-    {{- fail "autoscaling.websocketMetricName is required when autoscaling.enabled=true" -}}
+  {{- if and .Values.autoscaling.websocketMetricEnabled (not .Values.autoscaling.websocketMetricName) -}}
+    {{- fail "autoscaling.websocketMetricName is required when WebSocket scaling is enabled" -}}
   {{- end -}}
 {{- end -}}
 

deploy/charts/buzz/templates/hpa.yaml

@@ -22,11 +22,13 @@ spec:
         target:
           type: Utilization
           averageUtilization: {{ .Values.autoscaling.targetCPUUtilizationPercentage }}
+  {{- if .Values.autoscaling.websocketMetricEnabled }}
     - type: Pods
       pods:
         metric:
           name: {{ .Values.autoscaling.websocketMetricName }}
         target:
           type: AverageValue
           averageValue: {{ .Values.autoscaling.targetWebsocketConnections | quote }}
+  {{- end }}
 {{- end }}

deploy/charts/buzz/tests/hpa_test.yaml

@@ -49,6 +49,22 @@ tests:
           path: spec.behavior.scaleDown.stabilizationWindowSeconds
           value: 600
 
+  - it: supports CPU-only autoscaling without a custom metrics adapter
+    template: templates/hpa.yaml
+    set:
+      autoscaling.enabled: true
+      autoscaling.websocketMetricEnabled: false
+    asserts:
+      - lengthEqual:
+          path: spec.metrics
+          count: 1
+      - equal:
+          path: spec.metrics[0].type
+          value: Resource
+      - equal:
+          path: spec.metrics[0].resource.name
+          value: cpu
+
   - it: leaves Deployment replicas to the HPA and disables in-process huddle audio
     template: templates/deployment.yaml
     set:

deploy/charts/buzz/values.yaml

@@ -37,14 +37,15 @@ image:
 replicaCount: 1
 
 # ── Autoscaling ──────────────────────────────────────────────────────────────
-# Requires Metrics Server for CPU and a custom-metrics adapter exposing the
-# pod-level Prometheus gauge named by websocketMetricName. Kubernetes HPA uses
-# the larger replica recommendation, so either CPU or WebSocket load scales out.
+# Requires Metrics Server for CPU. Optional WebSocket scaling additionally
+# requires a custom-metrics adapter exposing its pod-level Prometheus gauge.
+# Kubernetes HPA uses the larger replica recommendation from enabled metrics.
 autoscaling:
   enabled: false
   minReplicas: 5
   maxReplicas: 15
   targetCPUUtilizationPercentage: 65
+  websocketMetricEnabled: true
   websocketMetricName: buzz_ws_connections_active
   targetWebsocketConnections: 5000
   behavior: