fix: prevent postgresql pod recreation during minor version upgrades (#286)

Replace the copy-init-sql init container (whose image tag was tied to
Chart.AppVersion) with a ConfigMap volume for init scripts. This ensures
the postgresql pod template only changes when its own configuration
changes, not on every chart version bump.

The init scripts are synced into the chart via vendir from db/init-scripts/
and loaded using Helm's .Files.Get into a ConfigMap.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: Levi080513

.gitignore

@@ -29,6 +29,9 @@ deploy/chart/neutree/grafana-dashboards
 deploy/docker/neutree-core/vmagent
 deploy/chart/neutree/vmagent
 
+# postgresql init scripts
+deploy/chart/neutree/init-scripts
+
 scripts/dashboard/ray-upstream
 scripts/dashboard/vllm-upstream
 scripts/dashboard/output

deploy/chart/neutree/templates/postgresql-deployment.yaml

@@ -20,16 +20,6 @@ spec:
       imagePullSecrets:
         {{- toYaml . | nindent 8 }}
       {{- end }}
-      initContainers:
-        - name: copy-init-sql
-          image: {{ include "neutree.image" (dict "global" .Values.global "componentRegistry" .Values.dbScripts.image.registry "repository" .Values.dbScripts.image.repository "tag" .Values.dbScripts.image.tag "defaultTag" .Chart.AppVersion) }}
-          imagePullPolicy: {{.Values.dbScripts.image.pullPolicy }}
-          command: ["/bin/sh", "-c"]
-          args:
-            - "cp -r /db/init-scripts/* /docker-entrypoint-initdb.d/"
-          volumeMounts:
-            - name: postgresql-initdb
-              mountPath: /docker-entrypoint-initdb.d
       containers:
         - name: neutree-postgresql
           env:
@@ -68,7 +58,8 @@ spec:
           persistentVolumeClaim:
             claimName: {{ include "neutree.fullname" . }}-postgresql-pvc
         - name: postgresql-initdb
-          emptyDir: {}
+          configMap:
+            name: {{ include "neutree.fullname" . }}-postgresql-initdb
       {{- with .Values.db.nodeSelector }}
       nodeSelector:
         {{- toYaml . | nindent 8 }}

deploy/chart/neutree/templates/postgresql-initdb-configmap.yaml

@@ -0,0 +1,9 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "neutree.fullname" . }}-postgresql-initdb
+  labels:
+    {{- include "neutree.labels" . | nindent 4 }}
+data:
+  000_init.sql: |
+    {{- .Files.Get "init-scripts/000_init.sql" | nindent 4 }}

vendir.lock.yml

@@ -24,4 +24,8 @@ directories:
   - directory: {}
     path: .
   path: deploy/chart/neutree/vmagent/
+- contents:
+  - directory: {}
+    path: .
+  path: deploy/chart/neutree/init-scripts/
 kind: LockConfig

vendir.yml

@@ -32,4 +32,10 @@ directories:
   contents:
   - path: .
     directory:
-      path: observability/vmagent/
+      path: observability/vmagent/
+
+- path: deploy/chart/neutree/init-scripts/
+  contents:
+  - path: .
+    directory:
+      path: db/init-scripts/