feat: add Helmfile-managed k8s charts for tasks 10-13

Local charts: kafka-cluster (Strimzi Kafka+KafkaNodePool CRs, 3-replica KRaft topology, 5Gi memory cap, Longhorn storage, pod anti-affinity), queue-crd (Queue CRD + queue-operator Deployment/RBAC), management-service (Deployment/Service/ConfigMap/HPA/Ingress, REST exposed externally via cert-manager-issued TLS, raw gRPC kept cluster-internal per design.md §7a). helmfile.yaml.gotmpl + releases.d/*.gotmpl wire strimzi-operator -> kafka-cluster -> redis -> {queue-crd, management-service} via `needs:`. Directory is releases.d, not helmfile.d as originally sketched in design.md section 7b: Helmfile v1 treats a literal "helmfile.d" directory as a special auto-discovery mode that conflicts with an explicit top-level helmfile.yaml. Files use .gotmpl (required by Helmfile v1 for {{ }}-templated files) and each declares its own environments: block, since nested helmfiles don't inherit the parent's resolved values in this version. Namespace is sqs throughout. environments/homelab.yaml carries no secrets. Validated locally via helm lint/helm template (all 3 charts) and `helmfile -e homelab build` (dependency ordering + value substitution) — no cluster contact made. Live apply is a separate, explicitly-confirmed step.
2026-06-22 06:31:41 -07:00
parent fd69e33a98
commit 918ba9393f
24 changed files with 784 additions and 0 deletions
@@ -0,0 +1,5 @@
+apiVersion: v2
+name: management-service
+description: kmsvc message-plane gRPC+REST server (design.md §1, §7a, §9)
+type: application
+version: 0.1.0
@@ -0,0 +1,12 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: management-service-config
+  namespace: {{ .Values.namespace }}
+data:
+  KMSVC_KAFKA_BROKERS: {{ .Values.env.kafkaBrokers | quote }}
+  KMSVC_REDIS_ADDR: {{ .Values.env.redisAddr | quote }}
+  KMSVC_AUTHENTIK_ISSUER_URL: {{ .Values.env.authentikIssuerURL | quote }}
+  KMSVC_AUTHENTIK_AUDIENCE: {{ .Values.env.authentikAudience | quote }}
+  KMSVC_GRPC_LISTEN_ADDR: ":{{ .Values.grpcPort }}"
+  KMSVC_HTTP_LISTEN_ADDR: ":{{ .Values.httpPort }}"
@@ -0,0 +1,39 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: management-service
+  namespace: {{ .Values.namespace }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      app: management-service
+  template:
+    metadata:
+      labels:
+        app: management-service
+    spec:
+      containers:
+        - name: management-service
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: grpc
+              containerPort: {{ .Values.grpcPort }}
+            - name: http
+              containerPort: {{ .Values.httpPort }}
+          envFrom:
+            - configMapRef:
+                name: management-service-config
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          readinessProbe:
+            tcpSocket:
+              port: {{ .Values.httpPort }}
+            initialDelaySeconds: 5
+            periodSeconds: 10
+          livenessProbe:
+            tcpSocket:
+              port: {{ .Values.httpPort }}
+            initialDelaySeconds: 10
+            periodSeconds: 20
@@ -0,0 +1,27 @@
+{{- if .Values.hpa.enabled }}
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: management-service
+  namespace: {{ .Values.namespace }}
+spec:
+  scaleTargetRef:
+    apiVersion: apps/v1
+    kind: Deployment
+    name: management-service
+  minReplicas: {{ .Values.hpa.minReplicas }}
+  maxReplicas: {{ .Values.hpa.maxReplicas }}
+  metrics:
+    - type: Resource
+      resource:
+        name: cpu
+        target:
+          type: Utilization
+          averageUtilization: {{ .Values.hpa.targetCPUUtilizationPercentage }}
+    - type: Resource
+      resource:
+        name: memory
+        target:
+          type: Utilization
+          averageUtilization: {{ .Values.hpa.targetMemoryUtilizationPercentage }}
+{{- end }}
@@ -0,0 +1,26 @@
+{{- if .Values.ingress.enabled }}
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: management-service
+  namespace: {{ .Values.namespace }}
+  annotations:
+    cert-manager.io/cluster-issuer: {{ .Values.ingress.clusterIssuer }}
+spec:
+  ingressClassName: {{ .Values.ingress.className }}
+  tls:
+    - hosts:
+        - {{ .Values.ingress.host }}
+      secretName: {{ .Values.ingress.tlsSecretName }}
+  rules:
+    - host: {{ .Values.ingress.host }}
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: management-service
+                port:
+                  number: {{ .Values.httpPort }}
+{{- end }}
@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: management-service
+  namespace: {{ .Values.namespace }}
+spec:
+  selector:
+    app: management-service
+  ports:
+    - name: grpc
+      port: {{ .Values.grpcPort }}
+      targetPort: {{ .Values.grpcPort }}
+    - name: http
+      port: {{ .Values.httpPort }}
+      targetPort: {{ .Values.httpPort }}
+  type: ClusterIP
@@ -0,0 +1,38 @@
+namespace: sqs
+replicaCount: 2
+
+image:
+  repository: forgejo.riotpiao.homelab.com/rock/kafka-management-service
+  tag: latest
+  pullPolicy: IfNotPresent
+
+grpcPort: 9090
+httpPort: 8080
+
+env:
+  kafkaBrokers: "kmsvc-kafka-bootstrap.sqs.svc.cluster.local:9092"
+  redisAddr: "kmsvc-redis-master.sqs.svc.cluster.local:6379"
+  authentikIssuerURL: ""
+  authentikAudience: ""
+
+resources:
+  requests:
+    cpu: 200m
+    memory: 256Mi
+  limits:
+    cpu: "1"
+    memory: 512Mi
+
+hpa:
+  enabled: true
+  minReplicas: 2
+  maxReplicas: 6
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+ingress:
+  enabled: true
+  className: nginx
+  clusterIssuer: homelab-ca
+  host: kmsvc.homelab.internal
+  tlsSecretName: kmsvc-tls