Kubernetes PostgreSQL – Streaming, Ablage und Import

Technische Referenz & Betriebsdokumentation

1. Ziel dieser Dokumentation

Dieses Dokument beschreibt:

Zugriff auf PostgreSQL-Pods in Kubernetes
Ablage großer SQL-Dateien im Persistent Volume (PV)
Streaming von Git-Repositories ohne lokale Speicherung
Sicheren und kontrollierten SQL-Import
Umgang mit Kubernetes Secrets
Risiken und empfohlene Vorgehensweisen

2. Platzhalter-Konvention

In allen Beispielen werden folgende Platzhalter verwendet:

<namespace>
<pod>
<secret>
<database>
<user>
<repo-url>
<commit>
<ordner>
<datei>
<key>

Diese sind projektspezifisch zu ersetzen.

3. Architekturüberblick

PostgreSQL speichert Daten im Persistent Volume unter:

/bitnami/postgresql

Wichtige Unterscheidung

Pfad	Bedeutung
`/opt/bitnami`	Container-Software
`/bitnami/postgresql`	Daten (Persistent Volume)
`/tmp`	Temporär, nicht persistent

Ablage-Ordner für Import-Dateien:

/bitnami/postgresql/<ordner>

4. Kubernetes – Grundbefehle

Alle Pods anzeigen

kubectl get pods -A

Pods in einem Namespace anzeigen

kubectl get pods -n <namespace>

Befehl in Pod ausführen

kubectl exec -n <namespace> <pod> -- <command>

Interaktive Shell starten

kubectl exec -it -n <namespace> <pod> -- sh

5. Persistent Volume prüfen

Speicherplatz prüfen

kubectl exec -n <namespace> <pod> -- df -h /bitnami/postgresql

Ordnerinhalt anzeigen

kubectl exec -n <namespace> <pod> -- ls -lh /bitnami/postgresql/<ordner>

Anzahl Dateien zählen

kubectl exec -n <namespace> <pod> -- \
sh -lc 'ls -1 /bitnami/postgresql/<ordner> | wc -l'

6. Streaming – Einzelne Datei ins PV speichern (ohne Ausführung)

curl -L "<raw-file-url>" \
| kubectl exec -i -n <namespace> <pod> -- \
sh -lc 'cat > /bitnami/postgresql/<ordner>/<datei>.sql'

Eigenschaften:

Kein lokales Speichern
Kein Ausführen
Reine Dateiablage im PV

7. Komplettes Repository direkt ins PV streamen

Repository als tar.gz streamen und entpacken

curl -L "<repo-url>/-/archive/<commit>/<project>-<commit>.tar.gz" \
| kubectl exec -i -n <namespace> <pod> -- \
sh -lc 'mkdir -p /bitnami/postgresql/<ordner> && \
cd /bitnami/postgresql/<ordner> && \
tar xz --strip-components=1'

Erklärung

curl lädt Archiv
Stream wird direkt an Pod weitergereicht
tar xz entpackt im PV
--strip-components=1 entfernt obersten Archiv-Ordner

Vorteile

Kein Speicherverbrauch auf Managementserver
Reproduzierbarer Stand durch Commit
Kein temporäres Ablegen

8. Kubernetes Secrets – Passwort abrufen

Secrets anzeigen

kubectl get secret -n <namespace>

Passwort dekodieren

kubectl get secret -n <namespace> <secret> \
-o jsonpath="{.data.<key>}" | base64 -d; echo

Typische Keys:

postgres-password
password

9. SQL-Import – Einzeldatei

kubectl exec -i -n <namespace> <pod> -- \
psql -U <user> -d <database> \
-f /bitnami/postgresql/<ordner>/<datei>.sql

Wichtig:

Datei wird ausgeführt
Änderungen sind persistent
Autocommit ist Standard

10. Batch-Import – Kontrollierte Ausführung

kubectl exec -it -n <namespace> <pod> -- sh -lc '
for f in /bitnami/postgresql/<ordner>/*.sql; do
  echo "RUN $f"
  psql -U <user> -d <database> \
       -v ON_ERROR_STOP=1 \
       -f "$f" || exit 1
done'