Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 9: Dependencies und Subcharts

Ziel: Ein eigenes Subchart postgres bauen, als Abhängigkeit einbinden und dem Release notes damit eine echte Datenbank geben – samt Migration im Init-Container. · Dauer: ca. 60 min · Voraussetzung: Tag 8

Briefing

  • dependencies in Chart.yaml ist der Wunsch (Versionsbereich), Chart.lock der Beschluss (genaue Version + Digest). dependency update löst auf, dependency build baut exakt nach Lock.
  • Ein Subchart sieht nur seinen eigenen Abschnitt der Werte und global.
  • Eltern- und Subchart landen in einem Release. Helm wartet nicht, bis die Datenbank bereit ist – die Anwendung muss das aushalten.
  • Bewusst kein fremdes PostgreSQL-Chart: Ein eigenes kleines Subchart zeigt jeden Mechanismus und bringt keine fremden Images mit.
 Release notes (ns notes)
 ├─ notes            Deployment notes ── initContainer migrate ──┐
 │   values: postgres.enabled, global.dbSecret                  │ NOTES_DB_URL
 └─ charts/postgres  StatefulSet notes-postgres + Service  <────┘
                     Secret notes-db (kubectl) <── beide lesen das Passwort

Drill 1: Das Subchart postgres

Das Subchart ist ein ganz normales Chart neben notes im Repo:

# auf prod
mkdir -p ~/helm/tag09 && cd ~/helm/charts
mkdir -p postgres/templates
cat > postgres/Chart.yaml <<'EOF'
# postgres/Chart.yaml – Stand Tag 09
apiVersion: v2
name: postgres
description: Kleines PostgreSQL als StatefulSet – Subchart von notes
type: application
version: 0.1.0
appVersion: "18.7"
EOF
cat > postgres/values.yaml <<'EOF'
# postgres/values.yaml – Stand Tag 09
image:
  repository: docker.io/library/postgres
  tag: 18.7-alpine
auth:
  # -- Benutzer und Datenbank, die beim ersten Start angelegt werden
  username: notes
  database: notes
  # -- Secret mit dem Passwort (leer = global.dbSecret)
  existingSecret: ""
  passwordKey: password
# -- Größe des PVC
storage: 1Gi
resources:
  requests:
    cpu: 20m
    memory: 64Mi
  limits:
    memory: 256Mi
EOF
cat > postgres/templates/_helpers.tpl <<'EOF'
{{/* postgres/templates/_helpers.tpl – Stand Tag 09 */}}
{{- define "postgres.fullname" -}}
{{- printf "%s-%s" .Release.Name .Chart.Name | trunc 63 | trimSuffix "-" }}
{{- end }}

{{- define "postgres.selectorLabels" -}}
app.kubernetes.io/name: {{ .Chart.Name }}
app.kubernetes.io/instance: {{ .Release.Name }}
{{- end }}

{{- define "postgres.secret" -}}
{{- $g := .Values.global | default dict }}
{{- required "auth.existingSecret oder global.dbSecret fehlt"
  (coalesce .Values.auth.existingSecret $g.dbSecret) }}
{{- end }}
EOF
cat > postgres/templates/service.yaml <<'EOF'
{{/* postgres/templates/service.yaml – Stand Tag 09 */}}
apiVersion: v1
kind: Service
metadata:
  name: {{ include "postgres.fullname" . }}
  labels:
    {{- include "postgres.selectorLabels" . | nindent 4 }}
spec:
  selector:
    {{- include "postgres.selectorLabels" . | nindent 4 }}
  ports:
    - name: postgres
      port: 5432
      targetPort: postgres
EOF
cat > postgres/templates/statefulset.yaml <<'EOF'
{{/* postgres/templates/statefulset.yaml – Stand Tag 09 */}}
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: {{ include "postgres.fullname" . }}
  labels:
    {{- include "postgres.selectorLabels" . | nindent 4 }}
spec:
  serviceName: {{ include "postgres.fullname" . }}
  replicas: 1
  selector:
    matchLabels:
      {{- include "postgres.selectorLabels" . | nindent 6 }}
  template:
    metadata:
      labels:
        {{- include "postgres.selectorLabels" . | nindent 8 }}
    spec:
      containers:
        - name: postgres
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          ports: [{name: postgres, containerPort: 5432}]
          env:
            - name: POSTGRES_USER
              value: {{ .Values.auth.username | quote }}
            - name: POSTGRES_DB
              value: {{ .Values.auth.database | quote }}
            - name: POSTGRES_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: {{ include "postgres.secret" . }}
                  key: {{ .Values.auth.passwordKey }}
          readinessProbe:
            exec:
              command: ["pg_isready", "-U", "{{ .Values.auth.username }}"]
            periodSeconds: 5
          resources:
            {{- toYaml .Values.resources | nindent 12 }}
          volumeMounts:
            - name: data
              mountPath: /var/lib/postgresql
  volumeClaimTemplates:
    - metadata:
        name: data
      spec:
        accessModes: [ReadWriteOnce]
        resources:
          requests:
            storage: {{ .Values.storage }}
EOF
helm lint postgres --set global.dbSecret=notes-db | tail -1
helm template db ./postgres --set global.dbSecret=notes-db \
  | grep -E '^kind|  name:|image:'
helm template db ./postgres 2>&1 | head -1

Erwartet:

1 chart(s) linted, 0 chart(s) failed
kind: Service
  name: db-postgres
kind: StatefulSet
  name: db-postgres
          image: "docker.io/library/postgres:18.7-alpine"
                  name: notes-db
        name: data
Error: execution error at (postgres/templates/statefulset.yaml:31:27):
auth.existingSecret oder global.dbSecret fehlt

PostgreSQL 18 legt seine Daten unter /var/lib/postgresql/18/ ab – darum hängt das Volume eine Ebene höher als bei älteren Versionen. .Values.global | default dict schützt den Baustein, wenn das Chart allein ohne global gerendert wird.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Abhängigkeit eintragen

# auf prod
cat >> notes/Chart.yaml <<'EOF'
dependencies:
  - name: postgres
    version: "~0.1.0"
    repository: file://../postgres
    condition: postgres.enabled
EOF
sed -i 's/^version: .*/version: 0.8.0/; s/Tag 08/Tag 09/' notes/Chart.yaml
helm dependency list notes
helm template notes ./notes -f values/prod.yaml 2>&1 | head -1
helm dependency update notes | tail -2
helm dependency list notes
ls notes/charts
cat notes/Chart.lock

Erwartet (gekürzt):

NAME      VERSION  REPOSITORY          STATUS
postgres  ~0.1.0   file://../postgres  missing
Error: an error occurred while checking for chart dependencies. You may need to run
'helm dependency build' to fetch missing dependencies: found in Chart.yaml, but missing
in charts/ directory: postgres
Saving 1 charts
Deleting outdated charts
NAME      VERSION  REPOSITORY          STATUS
postgres  ~0.1.0   file://../postgres  ok
postgres-0.1.0.tgz
dependencies:
- name: postgres
  repository: file://../postgres
  version: 0.1.0
digest: sha256:fda9b095c5a6…
generated: "2026-11-20T01:39:47.628254779Z"

~0.1.0 heißt „0.1.x“. update packt das Subchart als .tgz nach notes/charts/ und schreibt Chart.lock. Dein .gitignore schließt das .tgz aus, Chart.lock gehört ins Repo.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Die Schema-Falle

# auf prod
helm template notes ./notes -f values/prod.yaml 2>&1 | grep -E '^- at'
jq '.title = "notes – Stand Tag 09"
  | .properties.postgres = {"type": "object",
      "properties": {"enabled": {"type": "boolean"}}}' \
  notes/values.schema.json > /tmp/s.json && mv /tmp/s.json notes/values.schema.json
helm template notes ./notes -f values/prod.yaml 2>&1 | head -1
helm template notes ./notes -f values/prod.yaml --set global.dbSecret=notes-db 2>&1 \
  | grep -E '^- at'
jq '.properties.global = {"type": "object"}' notes/values.schema.json > /tmp/s.json \
  && mv /tmp/s.json notes/values.schema.json

Erwartet:

- at '': additional properties 'postgres' not allowed
Error: execution error at (notes/charts/postgres/templates/statefulset.yaml:31:27):
auth.existingSecret oder global.dbSecret fehlt
- at '': additional properties 'global' not allowed

Drei Lehren: Helm hängt die Werte des Subcharts unter postgres an die Eltern-Werte – additionalProperties: false lehnt sie ab, auch wenn du selbst nichts gesetzt hast. global fällt erst auf, wenn jemand es setzt. Und ohne postgres.enabled in den Werten ist die Bedingung nicht auffindbar, das Subchart also an. Darum kommt ein klarer Standard in values.yaml:

# auf prod
cat >> notes/values.yaml <<'EOF'

# -- Werte, die alle Charts sehen (auch das Subchart postgres)
global:
  # -- Secret mit dem DB-Passwort (Schlüssel password) für notes und postgres
  dbSecret: ""

postgres:
  # -- Eigenes PostgreSQL als Subchart mitliefern
  enabled: false
EOF
sed -i 's/Stand Tag 08/Stand Tag 09/' notes/values.yaml
helm template notes ./notes -f values/prod.yaml | grep -c 'Source: notes/charts'

Erwartet:

0

Fortschritt speichern? Kostenlos registrieren

Drill 4: Init-Container migrate

notes-api braucht die Tabelle notes, bevor sie Anfragen beantwortet. Der Unterbefehl migrate legt sie an (idempotent). Die DB-Umgebung brauchen Init-Container und Hauptcontainer gleich – ein Baustein in _helpers.tpl statt doppeltem YAML. Den Host leitet er aus dem Subchart ab, wenn keiner gesetzt ist.

# auf prod
cat >> notes/templates/_helpers.tpl <<'EOF'

{{/* DB-Umgebung für Init-Container und notes-api; leer = Speicherbetrieb */}}
{{- define "notes.dbEnv" -}}
{{- $db := .Values.database }}
{{- $secret := coalesce $db.existingSecret .Values.global.dbSecret }}
{{- if $secret }}
{{- $host := $db.host }}
{{- if and (not $host) .Values.postgres.enabled }}
{{- $host = printf "%s-postgres" .Release.Name }}
{{- end }}
- name: NOTES_DB_PASSWORD
  valueFrom:
    secretKeyRef:
      name: {{ $secret }}
      key: {{ $db.passwordKey }}
- name: NOTES_DB_URL
  value: {{ printf "postgres://%s:$(NOTES_DB_PASSWORD)@%s:%v/%s?%s" $db.user
    (required "database.host fehlt" $host) $db.port $db.name "sslmode=disable"
    | quote }}
{{- end }}
{{- end }}
EOF
sed -i 's/Stand Tag 07/Stand Tag 09/' notes/templates/_helpers.tpl
cat > notes/templates/deployment.yaml <<'EOF'
{{/* notes/templates/deployment.yaml – Stand Tag 09 */}}
{{- $dbEnv := include "notes.dbEnv" . }}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "notes.fullname" . }}
  labels:
    {{- include "notes.labels" . | nindent 4 }}
spec:
  replicas: {{ hasKey .Values "replicaCount" | ternary .Values.replicaCount 2 }}
  selector:
    matchLabels:
      {{- include "notes.selectorLabels" . | nindent 6 }}
  template:
    metadata:
      labels:
        {{- include "notes.labels" . | nindent 8 }}
      annotations:
        checksum/config: {{ include (print $.Template.BasePath "/config.yaml") .
          | sha256sum }}
    spec:
      terminationGracePeriodSeconds: {{ durationSeconds .Values.shutdownTimeout }}
      {{- if $dbEnv }}
      initContainers:
        - name: migrate
          image: {{ include "notes.image" . | quote }}
          args: ["migrate"]
          env:
            {{- $dbEnv | nindent 12 }}
      {{- end }}
      containers:
        - name: notes-api
          image: {{ include "notes.image" . | quote }}
          ports: [{name: http, containerPort: 8080}]
          env:
            - name: NOTES_API_KEY
              valueFrom:
                secretKeyRef:
                  name: {{ required "apiKey.existingSecret fehlt"
                    .Values.apiKey.existingSecret }}
                  key: {{ .Values.apiKey.key }}
            {{- with $dbEnv }}
            {{- . | nindent 12 }}
            {{- end }}
          envFrom:
            - configMapRef:
                name: {{ include "notes.fullname" . }}-config
          readinessProbe:
            httpGet: {path: /healthz, port: http}
          resources:
            {{- toYaml .Values.resources | nindent 12 }}
      {{- with .Values.nodeSelector }}
      nodeSelector:
        {{- toYaml . | nindent 8 }}
      {{- end }}
EOF
helm template notes ./notes -f values/prod.yaml -s templates/deployment.yaml \
  | grep -c NOTES_DB
helm template notes ./notes -f values/prod.yaml --set postgres.enabled=true \
  --set global.dbSecret=notes-db | grep -E '^kind|value: "postgres'

Erwartet (gekürzt):

0
kind: ConfigMap
kind: ConfigMap
kind: ConfigMap
kind: Service
kind: Service
kind: Deployment
              value: "postgres://notes:$(NOTES_DB_PASSWORD)@notes-postgres:5432/notes?…
              value: "postgres://notes:$(NOTES_DB_PASSWORD)@notes-postgres:5432/notes?…
kind: StatefulSet
kind: Ingress

Ohne Secret bleibt alles wie gestern (Speicherbetrieb, kein Init-Container). Mit Secret und Subchart kommen StatefulSet, Service, Init-Container und zweimal die URL dazu.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Helm wartet nicht auf die Datenbank

Jetzt bekommt der Release notes seine Datenbank – absichtlich ohne --wait, damit du zusehen kannst:

# auf prod
kubectl -n notes create secret generic notes-db --from-literal=password=lab-db-123
cat >> values/prod.yaml <<'EOF'
global:
  dbSecret: notes-db
postgres:
  enabled: true
EOF
sed -i 's/Stand Tag 08/Stand Tag 09/' values/prod.yaml
helm upgrade notes ./notes -n notes -f values/prod.yaml | grep -E 'REVISION|STATUS'
for i in 1 2 3 4 5 6; do sleep 5; kubectl -n notes get pods --no-headers; done

Erwartet (gekürzt):

secret/notes-db created
STATUS: deployed
REVISION: 20
notes-55cbbc96cf-7nrnh   1/1   Running             0            4m18s
notes-55cbbc96cf-hwxrw   1/1   Running             0            4m17s
notes-57d48b9df5-ptp6j   0/1   Init:Error          1 (4s ago)   6s
notes-postgres-0         0/1   ContainerCreating   0            6s
...
notes-57d48b9df5-ptp6j   0/1   Init:0/1            2 (15s ago)   17s
notes-postgres-0         0/1   ContainerCreating   0             17s
...
notes-57d48b9df5-ptp6j   0/1   Init:Error   2 (31s ago)   33s
notes-postgres-0         0/1   Running      0             33s

Helm meldet deployed, während der Init-Container noch scheitert: Postgres lädt sein Image und initialisiert sich. Kubernetes startet migrate mit wachsendem Abstand neu, die alten Pods laufen so lange weiter. Eine Minute später:

# auf prod
kubectl -n notes get pods
kubectl -n notes logs deploy/notes -c migrate --tail 1
curl -s -w ' %{http_code}\n' -H 'Host: api.notes.lab' -H 'X-API-Key: lab-key-123' \
  localhost/notes -d '{"text":"in Postgres"}'
for i in 1 2 3; do curl -s -H 'Host: api.notes.lab' localhost/notes; echo; done
kubectl -n notes exec notes-postgres-0 -- \
  psql -U notes -tAc 'select count(*) from notes'

Erwartet (gekürzt):

NAME                     READY   STATUS    RESTARTS   AGE
notes-57d48b9df5-fbdxz   1/1     Running   0          37s
notes-57d48b9df5-ptp6j   1/1     Running   0          80s
notes-postgres-0         1/1     Running   0          80s
time=2026-11-20T01:41:12.515Z level=INFO msg="migration complete" table=notes
{"id":"e725da85-…","text":"in Postgres"} 201
[{"id":"e725da85-…","text":"in Postgres"}]
[{"id":"e725da85-…","text":"in Postgres"}]
[{"id":"e725da85-…","text":"in Postgres"}]
1

Beide Pods sehen jetzt dieselbe Notiz. Die Init-Container-Neustarts sind hier der Mechanismus, der das „Warten“ erledigt – nicht Helm. Mit --wait hätte Helm nur gewartet, bis alles bereit ist, und bei Zeitüberschreitung failed gemeldet (Tag 13).

Fortschritt speichern? Kostenlos registrieren

Drill 6: Was das Subchart sieht, import-values

Experimente mit dem Abhängigkeitsbaum laufen in einer Kopie des ganzen Repos:

# auf prod
cd ~/helm/tag09 && rm -rf repo && cp -r ~/helm/charts repo && cd repo
cat > postgres/templates/sicht.yaml <<'EOF'
apiVersion: v1
kind: ConfigMap
metadata:
  name: sicht
data:
  storage: {{ .Values.storage | quote }}
  global: {{ .Values.global | toJson | quote }}
  elternTeam: {{ .Values.team | quote }}
  schluessel: {{ keys .Values | sortAlpha | join "," | quote }}
EOF
helm dependency update notes >/dev/null
helm template t ./notes --set apiKey.existingSecret=x --set global.dbSecret=s \
  --set postgres.enabled=true --set team=plattform --set postgres.storage=2Gi \
  -s charts/postgres/templates/sicht.yaml | sed -n '/^data/,$p'

Erwartet:

data:
  storage: "2Gi"
  global: "{\"dbSecret\":\"s\"}"
  elternTeam:
  schluessel: "auth,enabled,global,image,resources,storage"

Aus postgres.storage der Eltern wird .Values.storage im Subchart, team der Eltern ist unsichtbar, global kommt an. Nach einer Änderung am Subchart immer erst dependency update – sonst rendert Helm das alte .tgz. Die Gegenrichtung heißt import-values:

# auf prod
rm postgres/templates/sicht.yaml
cat >> notes/Chart.yaml <<'EOF'
    import-values:
      - child: auth
        parent: dbAuth
EOF
helm dependency update notes >/dev/null
jq 'del(.additionalProperties)' notes/values.schema.json > s.json
mv s.json notes/values.schema.json
cat > notes/templates/spielwiese.yaml <<'EOF'
apiVersion: v1
kind: ConfigMap
metadata:
  name: spiel
data:
  importiert: {{ .Values.dbAuth.username | quote }}
  direkt: {{ .Values.postgres.auth.username | quote }}
EOF
B='--set apiKey.existingSecret=x --set global.dbSecret=s --set postgres.enabled=true'
helm template t ./notes $B -s templates/spielwiese.yaml | sed -n '/^data/,$p'
helm template t ./notes $B --set postgres.auth.username=app \
  -s templates/spielwiese.yaml | sed -n '/^data/,$p'
helm template t ./notes --set apiKey.existingSecret=x -s templates/spielwiese.yaml \
  2>&1 | grep nil

Erwartet:

data:
  importiert: "notes"
  direkt: "notes"
data:
  importiert: "notes"
  direkt: "app"
    nil pointer evaluating interface {}.username

Zwei Fallen: import-values holt die Standardwerte des Subcharts, ein Override über postgres.auth.username kommt dort nicht an. Und ist das Subchart abgeschaltet, verschwinden seine Werte ganz – auch .Values.postgres.auth.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Chart.lock gegen Versionsbereich

# auf prod
cd ~/helm/tag09 && rm -rf repo && cp -r ~/helm/charts repo && cd repo
sed -i 's/^version: 0.1.0/version: 0.1.1/' postgres/Chart.yaml
helm dependency build notes 2>&1 | tail -1
helm dependency list notes
helm dependency update notes >/dev/null
ls notes/charts; yq '.dependencies[0].version' notes/Chart.lock
sed -i 's/version: "~0.1.0"/version: "~0.2.0"/' notes/Chart.yaml
helm dependency build notes 2>&1 | tail -1

Erwartet:

Error: can't get a valid version for dependency postgres
NAME      VERSION  REPOSITORY          STATUS
postgres  ~0.1.0   file://../postgres  ok
postgres-0.1.1.tgz
0.1.1
Error: the lock file (Chart.lock) is out of sync with the dependencies file
(Chart.yaml). Please update the dependencies with 'helm dependency update'

build besteht auf der Version aus Chart.lock (0.1.0). Ein file://-Repo bietet aber nur, was gerade im Ordner liegt – darum scheitert build. Mit einem echten Chart-Repository (Tag 15) liefert es exakt die gesperrte Version. dependency list meldet trotzdem ok: Es prüft nur, ob das .tgz zum Bereich passt, nicht zum Lock. Ändert sich Chart.yaml, verweigert build die Arbeit, bis jemand update ausführt.

Fortschritt speichern? Kostenlos registrieren

Drill 8: alias, tags und condition

Dasselbe Subchart zweimal, über Tags gemeinsam schaltbar:

# auf prod
cd ~/helm/tag09 && rm -rf repo && cp -r ~/helm/charts repo && cd repo
yq -i '.dependencies = [
  {"name": "postgres", "alias": "db-a", "version": "~0.1.0",
   "repository": "file://../postgres", "tags": ["datenbank"]},
  {"name": "postgres", "alias": "db-b", "version": "~0.1.0",
   "repository": "file://../postgres", "tags": ["datenbank"],
   "condition": "db-b.enabled"}]' notes/Chart.yaml
jq 'del(.additionalProperties)' notes/values.schema.json > s.json
mv s.json notes/values.schema.json
helm dependency update notes >/dev/null
B='--set apiKey.existingSecret=x --set global.dbSecret=s --set database.host=t-db-a'
helm template t ./notes $B --set db-b.storage=2Gi \
  | grep -E '^# Source: notes/charts|^  name: t-db|storage: '
helm template t ./notes $B --set tags.datenbank=false | grep -c 'notes/charts'
helm template t ./notes $B --set tags.datenbank=false --set db-b.enabled=true \
  | grep 'Source: notes/charts'

Erwartet:

# Source: notes/charts/db-a/templates/service.yaml
  name: t-db-a
# Source: notes/charts/db-b/templates/service.yaml
  name: t-db-b
# Source: notes/charts/db-a/templates/statefulset.yaml
  name: t-db-a
            storage: 1Gi
# Source: notes/charts/db-b/templates/statefulset.yaml
  name: t-db-b
            storage: 2Gi
0
# Source: notes/charts/db-b/templates/service.yaml
# Source: notes/charts/db-b/templates/statefulset.yaml

Mit alias heißt das Subchart im Template .Chart.Name = db-a – darum entstehen eigene Namen, und die Werte stehen unter db-a/db-b. tags schalten Gruppen, eine condition schlägt den Tag: db-b läuft trotz tags.datenbank=false.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Zeig den Status der Abhängigkeiten von notes. Zeitziel: 15 s
  2. Welche Subchart-Version ist gesperrt? Zeitziel: 15 s
  3. Zähle die Notizen direkt in Postgres. Zeitziel: 30 s
  4. Rendere nur das StatefulSet des Subcharts mit prod.yaml, zeig Image und Größe. Zeitziel: 30 s

Lösung

# auf prod
cd ~/helm/charts
helm dependency list notes
yq '.dependencies[0].version' notes/Chart.lock
kubectl -n notes exec notes-postgres-0 -- \
  psql -U notes -tAc 'select count(*) from notes'
helm template notes ./notes -f values/prod.yaml \
  -s charts/postgres/templates/statefulset.yaml | grep -E 'image:|storage:'

Erwartet:

NAME      VERSION  REPOSITORY          STATUS
postgres  ~0.1.0   file://../postgres  ok
0.1.0
1
          image: "docker.io/library/postgres:18.7-alpine"
            storage: 1Gi

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

# auf prod
helm list -n notes

Erwartet: Revision 20, notes-0.8.0, deployed.

# auf prod
kubectl -n notes get deploy notes \
  -o jsonpath='{.spec.template.spec.initContainers[0].args}{"\n"}'

Erwartet: ["migrate"]

# auf prod
kubectl -n notes get pvc

Erwartet: data-notes-postgres-0 mit Status Bound, 1Gi, local-path.

Challenge

Installiere in tag09 einen Release zwei aus einer Kopie, die postgres zweimal (db-a, db-b) mitbringt; notes-api nutzt db-a. Warte, bis alles bereit ist, deinstalliere den Release und prüfe, was übrig bleibt.

Hinweis: Die PVCs eines StatefulSets entstehen aus volumeClaimTemplates – nicht aus dem Chart.

Lösung

# auf prod
cd ~/helm/tag09 && rm -rf repo && cp -r ~/helm/charts repo && cd repo
yq -i '.dependencies = [
  {"name": "postgres", "alias": "db-a", "version": "~0.1.0",
   "repository": "file://../postgres"},
  {"name": "postgres", "alias": "db-b", "version": "~0.1.0",
   "repository": "file://../postgres"}]' notes/Chart.yaml
jq '.properties["db-a"] = {"type": "object"}
  | .properties["db-b"] = {"type": "object"}' \
  notes/values.schema.json > s.json && mv s.json notes/values.schema.json
helm dependency update notes | tail -1
kubectl create namespace tag09
kubectl -n tag09 create secret generic notes-db --from-literal=password=lab-db-123
kubectl -n tag09 create secret generic notes-api-key --from-literal=api-key=lab-key-123
helm install zwei ./notes -n tag09 --set apiKey.existingSecret=notes-api-key \
  --set global.dbSecret=notes-db --set database.host=zwei-db-a --set replicaCount=1 \
  --wait --timeout 3m | grep STATUS
kubectl -n tag09 get statefulset,pvc
helm uninstall zwei -n tag09
kubectl -n tag09 get pvc

Erwartet (gekürzt):

STATUS: deployed
NAME                         READY   AGE
statefulset.apps/zwei-db-a   1/1     43s
statefulset.apps/zwei-db-b   1/1     43s

NAME                                     STATUS   ...   CAPACITY   ...
persistentvolumeclaim/data-zwei-db-a-0   Bound    ...   1Gi        ...
persistentvolumeclaim/data-zwei-db-b-0   Bound    ...   1Gi        ...
release "zwei" uninstalled
NAME               STATUS   ...   CAPACITY   ...
data-zwei-db-a-0   Bound    ...   1Gi        ...
data-zwei-db-b-0   Bound    ...   1Gi        ...

helm uninstall löscht, was im Manifest steht. Die PVCs hat der StatefulSet-Controller angelegt, sie überleben – gut für Daten, schlecht für Wegwerf-Umgebungen. Wer neu installiert, bekommt die alten Daten (und das alte Passwort) zurück.

Fortschritt speichern? Kostenlos registrieren

Aufräumen

# auf prod
kubectl delete namespace tag09
cd ~/helm/charts
git add -A
git commit -qm "Tag 09: Subchart postgres, global, Init-Container migrate, notes 0.8.0"

Erwartet:

namespace "tag09" deleted

Interview-Notiz

  • dependency update oder build? update löst die Bereiche neu auf und schreibt Chart.lock, build holt exakt die gesperrten Versionen. Im CI build, damit Builds reproduzierbar sind.
  • Wie gibst du Werte an ein Subchart? Unter seinem Namen (oder Alias) in den Eltern-Werten; was alle brauchen, unter global. Das Subchart sieht nur das.
  • Wartet Helm, bis die Datenbank bereit ist? Nein. Eltern- und Subchart werden gemeinsam angewendet. Init-Container, Retries in der App oder Hooks (Tag 11) müssen die Reihenfolge herstellen.

Enterprise-Notiz

  • Für echte Datenbanken liefert ein Operator (z. B. CloudNativePG) Backups, Failover und Upgrades; das App-Chart verweist dann nur noch auf dessen Secret (existingSecret-Muster aus Tag 8).
  • Subcharts aus fremden Repos immer mit genauer Version und Chart.lock im Git; das charts/-Verzeichnis entsteht im CI per dependency build.
  • Ein Schema mit additionalProperties: false muss jeden Subchart-Namen, jeden Alias und global kennen – sonst bricht das erste Update eines Subcharts die Validierung.
  • PVCs aus volumeClaimTemplates überleben helm uninstall. Aufräumen gehört in den Ablauf für Wegwerf-Umgebungen, Löschen in Produktion braucht eine bewusste Freigabe.