Tag 9: Dependencies und Subcharts
Ziel: Ein eigenes Subchart
postgresbauen, als Abhängigkeit einbinden und dem Releasenotesdamit eine echte Datenbank geben – samt Migration im Init-Container. · Dauer: ca. 60 min · Voraussetzung: Tag 8
Briefing
dependenciesinChart.yamlist der Wunsch (Versionsbereich),Chart.lockder Beschluss (genaue Version + Digest).dependency updatelöst auf,dependency buildbaut 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 -1Erwartet:
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.lockErwartet (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.jsonErwartet:
- 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; doneErwartet (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 nilErwartet:
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 -1Erwartet:
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
- Zeig den Status der Abhängigkeiten von
notes. Zeitziel: 15 s - Welche Subchart-Version ist gesperrt? Zeitziel: 15 s
- Zähle die Notizen direkt in Postgres. Zeitziel: 30 s
- 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 notesErwartet: 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 pvcErwartet: 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 pvcErwartet (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 updateoderbuild?updatelöst die Bereiche neu auf und schreibtChart.lock,buildholt exakt die gesperrten Versionen. Im CIbuild, 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.lockim Git; dascharts/-Verzeichnis entsteht im CI perdependency build. - Ein Schema mit
additionalProperties: falsemuss jeden Subchart-Namen, jeden Alias undglobalkennen – sonst bricht das erste Update eines Subcharts die Validierung. - PVCs aus
volumeClaimTemplatesüberlebenhelm uninstall. Aufräumen gehört in den Ablauf für Wegwerf-Umgebungen, Löschen in Produktion braucht eine bewusste Freigabe.