Update: migration guide and README for external PostgreSQL requirement; enhance deployment.yaml with DATABASE_URL env vars

Author: enoy19

MIGRATION.md

@@ -9,14 +9,6 @@ This guide helps you migrate from previous versions of the Kudos Helm chart to v
 - **Configuration structure changed**: Database connection settings are completely different
 - **No backward compatibility**: Complete migration required
 
-## Why This Change?
-
-This change follows the **KISS principle** (Keep It Simple, Stupid):
-- **Separation of concerns**: Database administration is distinct from application deployment  
-- **Production ready**: External databases offer better reliability, backup, and scaling
-- **Flexibility**: Choose your preferred database hosting solution
-- **Reduced complexity**: Kudos focuses on the application, not database operations
-
 ## Pre-Migration Requirements
 
 1. **Set up an external PostgreSQL database** (see [DATABASE_SETUP.md](../DATABASE_SETUP.md))

README.md

@@ -67,7 +67,7 @@ KUDOS_MIGRATE="1"
 
 ### Database Setup
 
-**Important**: Starting with Helm Chart v2.0.0, Kudos requires an external PostgreSQL database. The application no longer manages database infrastructure to follow KISS principles and production best practices.
+**Important**: Starting with Helm Chart v2.0.0, Kudos requires an external PostgreSQL database. The application no longer manages database infrastructure.
 
 📖 **See [DATABASE_SETUP.md](DATABASE_SETUP.md)** for comprehensive instructions on setting up PostgreSQL for Kudos, including:
 - Cloud database services (AWS RDS, Google Cloud SQL, Azure Database)

docs/helm/index.yaml

@@ -6,9 +6,9 @@ entries:
       licenses: MIT
     apiVersion: v2
     appVersion: 1.2.1
-    created: "2025-09-17T16:38:46.950966+02:00"
+    created: "2025-09-17T16:42:29.997157+02:00"
     description: Kudos Helm chart for deploying social recognition platform
-    digest: b6713b3c4c8acbc290270670cb7da86bc7db64121e1babe380aef0b3c675ffcc
+    digest: 3db9f6b21d15cc5b91f18e491d6b42baba7519084c6a33a62c1a1fca261147fc
     keywords:
     - kudos
     - social
@@ -22,7 +22,7 @@ entries:
     version: 2.0.0
   - apiVersion: v2
     appVersion: 1.2.1
-    created: "2025-09-17T16:38:46.950763+02:00"
+    created: "2025-09-17T16:42:29.996928+02:00"
     dependencies:
     - condition: postgresql.enabled
       name: postgresql
@@ -37,7 +37,7 @@ entries:
     version: 0.2.1
   - apiVersion: v2
     appVersion: 1.2.0
-    created: "2025-09-17T16:38:46.94897+02:00"
+    created: "2025-09-17T16:42:29.99512+02:00"
     dependencies:
     - condition: postgresql.enabled
       name: postgresql
@@ -52,7 +52,7 @@ entries:
     version: 0.2.0
   - apiVersion: v2
     appVersion: 1.2.0
-    created: "2025-09-17T16:38:46.946448+02:00"
+    created: "2025-09-17T16:42:29.993246+02:00"
     dependencies:
     - condition: postgresql.enabled
       name: postgresql
@@ -65,4 +65,4 @@ entries:
     urls:
     - https://synyx.github.io/kudos/docs/helm/kudos-0.1.1.tgz
     version: 0.1.1
-generated: "2025-09-17T16:38:46.943837+02:00"
+generated: "2025-09-17T16:42:29.990771+02:00"

docs/helm/kudos-2.0.0.tgz

@@ -84,11 +84,11 @@ PostgreSQL password secret key
 {{- end }}
 
 {{/*
-Build DATABASE_URL from components
+Build DATABASE_URL with environment variable substitution
 */}}
 {{- define "kudos.postgresql.connectionString" -}}
 {{- $host := .Values.postgresql.host }}
-{{- $port := .Values.postgresql.port | default 5432 }}
+{{- $port := .Values.postgresql.port | default 5432 | int }}
 {{- $database := .Values.postgresql.database | default "kudos" }}
 {{- $sslMode := .Values.postgresql.sslMode | default "disable" }}
 {{- $baseUrl := printf "postgresql://$(DATABASE_USER):$(DATABASE_PASSWORD)@%s:%d/%s" $host $port $database }}

helm/kudos/templates/_helpers.tpl

@@ -6,9 +6,7 @@ metadata:
   labels:
     {{- include "kudos.labels" . | nindent 4 }}
 spec:
-  {{- if not .Values.autoscaling.enabled }}
   replicas: {{ .Values.replicaCount }}
-  {{- end }}
   selector:
     matchLabels:
       {{- include "kudos.selectorLabels" . | nindent 6 }}
@@ -34,6 +32,16 @@ spec:
           command: ["npm"]
           args: ["run", "db:migrate"]
           env:
+            - name: DATABASE_USER
+              valueFrom:
+                secretKeyRef:
+                  name: {{ include "kudos.postgresql.secretName" . }}
+                  key: {{ include "kudos.postgresql.usernameKey" . }}
+            - name: DATABASE_PASSWORD
+              valueFrom:
+                secretKeyRef:
+                  name: {{ include "kudos.postgresql.secretName" . }}
+                  key: {{ include "kudos.postgresql.passwordKey" . }}
             - name: DATABASE_URL
               value: {{ include "kudos.postgresql.connectionString" . | quote }}
           resources:
@@ -56,6 +64,16 @@ spec:
           env:
             - name: ORIGIN
               value: {{ .Values.app.origin | quote }}
+            - name: DATABASE_USER
+              valueFrom:
+                secretKeyRef:
+                  name: {{ include "kudos.postgresql.secretName" . }}
+                  key: {{ include "kudos.postgresql.usernameKey" . }}
+            - name: DATABASE_PASSWORD
+              valueFrom:
+                secretKeyRef:
+                  name: {{ include "kudos.postgresql.secretName" . }}
+                  key: {{ include "kudos.postgresql.passwordKey" . }}
             - name: DATABASE_URL
               value: {{ include "kudos.postgresql.connectionString" . | quote }}
             - name: KUDOS_MIGRATION

helm/kudos/templates/deployment.yaml

@@ -18,7 +18,10 @@
     "db:generate": "drizzle-kit generate",
     "db:push": "drizzle-kit push",
     "db:migrate": "drizzle-kit migrate",
-    "db:studio": "drizzle-kit studio"
+    "db:studio": "drizzle-kit studio",
+    "helm:release": "echo 'Packaging Helm chart...' && helm package helm/kudos -d docs/helm/ && echo 'Updating repository index...' && helm repo index docs/helm/ --url https://synyx.github.io/kudos/docs/helm && echo 'Helm release complete! 🎉'",
+    "helm:lint": "helm lint helm/kudos",
+    "helm:template": "helm template test-release helm/kudos --values helm/kudos/values.yaml"
   },
   "devDependencies": {
     "@eslint/compat": "^1.2.5",