add: actual-budget-exporter app

Prometheus exporter for Actual Budget. actual_server itself stays in homelab-docker-compose-prod (host docker-compose), exporter only scrapes it over LAN and exposes /metrics via a ServiceMonitor. No HTTPRoute. Password and budget ID come from a hand-created Secret, not committed.
2026-09-03 15:37:59 +07:00
parent 08422398fc
commit e9fa39f3f4
7 changed files with 178 additions and 3 deletions
@@ -0,0 +1,17 @@
+apiVersion: argoproj.io/v1alpha1
+kind: Application
+metadata:
+  name: actual-budget-exporter
+  namespace: argocd
+spec:
+  project: default
+  source:
+    repoURL: https://gitea.fireflylab.cc/duynguyen/homelab-services.git
+    targetRevision: main
+    path: apps/actual-budget-exporter/chart
+  destination:
+    server: https://kubernetes.default.svc
+    namespace: actualbudget
+  syncPolicy:
+    syncOptions:
+      - CreateNamespace=true
@@ -0,0 +1,6 @@
+apiVersion: v2
+name: actual-budget-exporter
+description: Prometheus exporter for Actual Budget (https://github.com/sakowicz/actual-budget-prometheus-exporter)
+type: application
+version: 0.1.0
+appVersion: "latest"
@@ -0,0 +1,52 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ .Release.Name }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      app: {{ .Release.Name }}
+  template:
+    metadata:
+      labels:
+        app: {{ .Release.Name }}
+    spec:
+      containers:
+        - name: actual-budget-exporter
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: metrics
+              containerPort: {{ .Values.service.port }}
+          env:
+            {{- range $k, $v := .Values.env }}
+            - name: {{ $k }}
+              value: {{ $v | quote }}
+            {{- end }}
+            - name: ACTUAL_PASSWORD
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.secret.name }}
+                  key: ACTUAL_PASSWORD
+            - name: ACTUAL_BUDGET_ID_1
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.secret.name }}
+                  key: ACTUAL_BUDGET_ID_1
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          # No documented dedicated health endpoint; /metrics is the route
+          # that's always up once the exporter has started.
+          readinessProbe:
+            httpGet:
+              path: /metrics
+              port: {{ .Values.service.port }}
+            initialDelaySeconds: 5
+            periodSeconds: 10
+          livenessProbe:
+            httpGet:
+              path: /metrics
+              port: {{ .Values.service.port }}
+            initialDelaySeconds: 15
+            periodSeconds: 20
@@ -0,0 +1,14 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ .Release.Name }}
+  labels:
+    app: {{ .Release.Name }}
+spec:
+  type: {{ .Values.service.type }}
+  selector:
+    app: {{ .Release.Name }}
+  ports:
+    - name: metrics
+      port: {{ .Values.service.port }}
+      targetPort: {{ .Values.service.port }}
@@ -0,0 +1,22 @@
+{{- if .Values.serviceMonitor.enabled }}
+apiVersion: monitoring.coreos.com/v1
+kind: ServiceMonitor
+metadata:
+  name: {{ .Release.Name }}
+  labels:
+    # kube-prometheus-stack's default serviceMonitorSelector only picks up
+    # ServiceMonitors carrying this label (release name of that Helm
+    # release, set by its ArgoCD Application name in cluster-platform).
+    release: kube-prometheus-stack
+spec:
+  namespaceSelector:
+    matchNames:
+      - {{ .Release.Namespace }}
+  selector:
+    matchLabels:
+      app: {{ .Release.Name }}
+  endpoints:
+    - port: metrics
+      path: /metrics
+      interval: {{ .Values.serviceMonitor.interval }}
+{{- end }}
@@ -0,0 +1,35 @@
+image:
+  repository: docker.io/sakowicz/actual-budget-prometheus-exporter
+  tag: latest
+  pullPolicy: IfNotPresent
+
+replicaCount: 1
+
+service:
+  type: ClusterIP
+  port: 3001
+
+# actual_server is NOT in this cluster — it's a plain docker-compose
+# container on the homelab host (see homelab-docker-compose-prod/actualbudget),
+# published on the host LAN IP. Reach it the same way actual-http-api does.
+env:
+  ACTUAL_SERVER_URL: "http://192.168.1.41:8002"
+  # ACTUAL_BUDGET_NAME_1: ""    # optional, adds a friendly name to the prometheus label
+  # ACTUAL_E2E_PASSWORD_1: ""   # optional, only if E2E encryption is enabled on the budget
+
+# ACTUAL_PASSWORD and ACTUAL_BUDGET_ID_1 are NOT set here — plaintext Actual
+# credentials in a git-committed values.yaml is not acceptable. They're read
+# from a Secret you create by hand once (see README.md), never committed.
+secret:
+  name: actual-budget-exporter-secrets
+
+resources:
+  requests:
+    cpu: 50m
+    memory: 64Mi
+  limits:
+    memory: 128Mi
+
+serviceMonitor:
+  enabled: true
+  interval: 30s