feat: ArgoCD health check for VinylCache via Helm chart (#22)

When argocd.resourceCustomizations.enabled=true, the chart deploys
a ConfigMap in the ArgoCD namespace with a custom Lua health check
for VinylCache resources. ArgoCD discovers it via the
app.kubernetes.io/part-of: argocd label.

Health states:
- Ready=True → Healthy
- Ready=False → Degraded
- No Ready condition → Progressing

Includes Helm unit tests for all scenarios.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: jensens

charts/cloud-vinyl/templates/argocd-health.yaml

@@ -0,0 +1,30 @@
+{{- if .Values.argocd.resourceCustomizations.enabled }}
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "cloud-vinyl.fullname" . }}-argocd-health
+  namespace: {{ .Values.argocd.namespace | default "argocd" }}
+  labels:
+    app.kubernetes.io/part-of: argocd
+    {{- include "cloud-vinyl.labels" . | nindent 4 }}
+data:
+  resource.customizations.health.vinyl.bluedynamics.eu_VinylCache: |
+    hs = {}
+    if obj.status ~= nil and obj.status.conditions ~= nil then
+      for _, c in ipairs(obj.status.conditions) do
+        if c.type == "Ready" and c.status == "True" then
+          hs.status = "Healthy"
+          hs.message = c.message
+          return hs
+        end
+        if c.type == "Ready" and c.status == "False" then
+          hs.status = "Degraded"
+          hs.message = c.message
+          return hs
+        end
+      end
+    end
+    hs.status = "Progressing"
+    hs.message = "Waiting for VinylCache to become ready"
+    return hs
+{{- end }}

charts/cloud-vinyl/tests/argocd_test.yaml

@@ -0,0 +1,49 @@
+suite: ArgoCD Health Check Tests
+templates:
+  - argocd-health.yaml
+tests:
+  - it: should not render when argocd.resourceCustomizations.enabled is false
+    set:
+      argocd:
+        resourceCustomizations:
+          enabled: false
+    asserts:
+      - hasDocuments:
+          count: 0
+
+  - it: should render ConfigMap when argocd.resourceCustomizations.enabled is true
+    set:
+      argocd:
+        resourceCustomizations:
+          enabled: true
+        namespace: argocd
+    asserts:
+      - isKind:
+          of: ConfigMap
+      - equal:
+          path: metadata.namespace
+          value: argocd
+      - isSubset:
+          path: metadata.labels
+          content:
+            app.kubernetes.io/part-of: argocd
+
+  - it: should contain VinylCache health check Lua script
+    set:
+      argocd:
+        resourceCustomizations:
+          enabled: true
+    asserts:
+      - exists:
+          path: data["resource.customizations.health.vinyl.bluedynamics.eu_VinylCache"]
+
+  - it: should use custom namespace when set
+    set:
+      argocd:
+        resourceCustomizations:
+          enabled: true
+        namespace: custom-argocd
+    asserts:
+      - equal:
+          path: metadata.namespace
+          value: custom-argocd

charts/cloud-vinyl/values.schema.json

@@ -145,6 +145,20 @@
     },
     "affinity": {"type": "object"},
     "podSecurityContext": {"type": "object"},
-    "securityContext": {"type": "object"}
+    "securityContext": {"type": "object"},
+    "argocd": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "resourceCustomizations": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {"type": "boolean"}
+          }
+        },
+        "namespace": {"type": "string"}
+      }
+    }
   }
 }

charts/cloud-vinyl/values.yaml

@@ -95,3 +95,12 @@ securityContext:
   capabilities:
     drop:
       - ALL
+
+# ArgoCD integration.
+argocd:
+  resourceCustomizations:
+    # Deploy a ConfigMap with a custom health check for VinylCache resources.
+    # ArgoCD picks this up automatically via the app.kubernetes.io/part-of: argocd label.
+    enabled: false
+  # Namespace where ArgoCD is installed.
+  namespace: argocd