Willkommen im Trainingslager
Du betreibst Server oder Plattformen, und irgendwo darunter läuft PostgreSQL. Solange alles läuft, merkt das niemand. Dann ist die Platte voll mit WAL, eine Abfrage hält seit Stunden eine Sperre, das Backup von gestern lässt sich nicht einspielen, oder der Primary ist weg und keiner weiß, ob der Standby aktuell war. Dieses Buch bereitet dich auf genau diese Momente vor – nicht mit Theorie, sondern im Terminal.
Der Weg führt in zwei Teilen vom einzelnen Server bis zum Operator. Im ersten Teil betreibst du PostgreSQL klassisch auf zwei VMs: installieren, absichern, konfigurieren, Abfragen verstehen, aufräumen, überwachen, sichern, wiederherstellen, replizieren, poolen und upgraden. Im zweiten Teil übernimmt CloudNativePG auf Kubernetes dieselben Aufgaben – und weil du sie vorher von Hand erledigt hast, weißt du, was der Operator eigentlich tut und wo du nachsehen musst, wenn er es nicht tut.
Das Buch richtet sich an Admins, DevOps- und Plattform-Engineers mit
Linux-Grundlagen: Du solltest dich per ssh anmelden, mit
sudo, systemctl und journalctl
umgehen und Konfigurationsdateien bearbeiten können. SQL-Grundwissen
hilft, wird aber kurz aufgefrischt. Für den zweiten Teil brauchst du
Kubernetes-Grundlagen: Pods, Services, Secrets und PVCs, YAML lesen,
kubectl bedienen.
So funktioniert das Buch
- Ein Tag, ein Thema. Jeder Tag hat ein Ziel, eine Zeitangabe, ein kurzes Briefing und 5–8 Drills. Du tippst jeden Befehl selbst und vergleichst mit „Erwartet“.
- Vorher, konfigurieren, nachher. Jede Funktion
beginnt mit dem Zustand ohne sie und endet mit einem Nachweis: eine
Abfrage auf
pg_stat_*, eine Zeile im Log, ein gelungener Restore, ein überstandener Ausfall. - Kein Hilfsskript. Jeder Schritt steht als einzelner Befehl da, auch der Kontrollpunkt am Ende jedes Tages.
- Speed-Drills am Ende jedes Tages: kleine Aufgaben mit Zeitziel.
- Kontrollpunkt, Challenge, Interview-Notiz, Enterprise-Notiz schließen jeden Tag ab. Die Interview-Notiz sammelt die Fragen, die im Vorstellungsgespräch oder im Bereitschaftsdienst zum Thema fallen, samt Kernantwort. Die Enterprise-Notiz sagt, was in Produktion anders ist als im Labor.
- Eine Datenbank durch viele Tage:
notes, die Datenbank der kleinen Go-API notes-api. Für Last und größere Datenmengen kommengenerate_seriesundpgbenchdazu.
Teil 1 – PostgreSQL auf VMs:
| Tage | Thema |
|---|---|
| 0–3 | Gelände, psql, Rollen und Rechte, Konfiguration,
pg_hba.conf, TLS |
| 4–7 | MVCC und Sperren, Indizes und EXPLAIN, VACUUM,
Monitoring und Logs |
| 8–11 | Logische und physische Backups, PITR, Streaming- und logische Replikation |
| 12–13 | Connection Pooling mit PgBouncer, Major-Upgrade |
Teil 2 – CloudNativePG auf Kubernetes:
| Tage | Thema |
|---|---|
| 14 | Operator installieren, erster Cluster mit drei Instanzen |
| 15 | Backups in einen Objektspeicher, Point-in-Time-Recovery in einen neuen Cluster |
| 16 | Hochverfügbarkeit: Failover, Switchover, Rolling Update, Fencing, Upgrade |
| 17 | Betrieb: Pooler, Monitoring, deklarative Rollen und Datenbanken, TLS, Ressourcen |
| 18 | Anwendung anbinden: Secrets, Verbindung aus Pods, Migrationen, Read-Replicas |
Zum Schluss:
- Wettkampf (Tag 19): kaputte Datenbanken, die du unter Zeitdruck reparierst.
- Anhang A ist der Spickzettel, Anhang B die Abschlussprüfung: zwei Stunden, rund 16 Aufgaben quer durch das Buch.
Was du brauchst
Für Teil 1 zwei VMs mit Ubuntu 24.04 im selben Netz, mit SSH-Zugang
und sudo:
| Rolle | Aufgabe | IP im Buch | Im Labor |
|---|---|---|---|
| pg1 | Primary, Hauptarbeitsplatz | 172.16.0.182 | 4 vCPU, 8 GB RAM |
| pg2 | Client, Backup-Ziel, Standby | 172.16.0.123 | 2 vCPU, 4 GB RAM |
Die VMs heißen im Labor argo und prod –
nenne deine, wie du willst, und setze überall deine eigenen IPs ein.
Zwischen den VMs gibt es keine Namensauflösung; das Buch arbeitet
deshalb überall mit IPs.
Proxmox, VMware, eine Cloud oder Multipass – egal. Auf dem eigenen Rechner ist Multipass der einfachste Weg. Damit Tag 0 deinen SSH-Schlüssel auf beiden VMs vorfindet, gibst du ihn per cloud-init mit:
cat > pg-cloud-init.yaml <<EOF
#cloud-config
ssh_authorized_keys:
- $(cat ~/.ssh/id_ed25519.pub)
EOF
multipass launch 24.04 --name pg1 --cpus 4 --memory 8G --disk 40G \
--cloud-init pg-cloud-init.yaml
multipass launch 24.04 --name pg2 --cpus 2 --memory 4G --disk 30G \
--cloud-init pg-cloud-init.yaml
multipass listmultipass list zeigt die IPs. Auf einem Mac mit Apple
Silicon sind die VMs arm64. Das PGDG-Repository baut PostgreSQL und
PgBouncer auch für arm64, alle Paketquellen und Downloads im Buch
ermitteln die Architektur selbst – in Dateinamen und Ausgaben steht bei
dir dann arm64, wo das Buch amd64 zeigt.
Für Teil 2 brauchst du zusätzlich einen kubeadm-Cluster mit drei
Nodes, auf dem du Cluster-Admin bist. Im Labor ist das der Cluster
ost (eine Control Plane cp1 mit 172.16.0.126,
zwei Worker mit je 2 vCPU und 4 GB, Cilium als CNI). Hast du das Gelände
aus „CKA zum Anfassen“ oder „Cilium zum Anfassen“ noch, nimm es. Ehrlich
gesagt, was die Tage voraussetzen:
- Tag 14: eine StorageClass
local-path(im Labor die Default-Klasse; heißt deine anders, setze ihren Namen ein) und Platz für drei kleine PostgreSQL-Pods mit je 256 MiB Request. - cert-manager und kube-prometheus-stack installierst du in Tag 14
selbst (Release
kpsim Namespacemonitoring); hast du sie schon, nutzt du deine und setzt Release-Namen, Namespace und Grafana-Passwort entsprechend ein. - Tag 16: mehr als einen Worker, damit ein Node ausfallen kann,
während die Datenbank auf einem anderen weiterläuft. Für Drill 3 SSH von
cp1auf die Worker (Benutzer mitsudo) undcrictldort. - Tag 18: ein CNI, das NetworkPolicies durchsetzt; für Drill 8 Cilium
samt
cilium- undhubble-CLI und Hubble Relay (wie im Cilium-Buch). Ohne Cilium entfallen Hubble und dieCiliumNetworkPolicy. pg1,pg2und der Cluster sollten sich gegenseitig im Netz erreichen: In Tag 14 verbindet sichpg2von außen mit dem Cluster, in Tag 17 holt sich Prometheus Metriken vonpg1.
Zeit: Tag 0 bis 14 summieren sich auf knapp 21 Stunden (1255 Minuten). Tag 15 bis 18 kommen mit 75 bis 90 Minuten dazu (zusammen 330 Minuten), der Wettkampf an Tag 19 mit 120 Minuten – insgesamt rund 28 Stunden, plus die zweistündige Abschlussprüfung. Bei einem Trainingstag pro Abend und fünf Abenden pro Woche bist du in gut vier Wochen durch.
In Tag 0 installierst du PostgreSQL 18 aus dem offiziellen Repository des Projekts (PGDG, apt.postgresql.org) statt der Version 16 aus Ubuntu. PostgreSQL 19 lag bei Redaktionsschluss als Release Candidate vor. Tag 13 übt das Major-Upgrade deshalb von 17 auf 18 und zeigt dir, wie du prüfst, ob 19 inzwischen freigegeben ist – die Handgriffe sind dieselben.
Das Begleitrepo
Quellcode von notes-api (Ordner notes-api) und das
Material zum Buch liegen unter
https://github.com/thomaszachmann/postgresql-zum-anfassen.
Bauen musst du nichts: Das Image
ghcr.io/thomaszachmann/notes-api:0.5.1 gibt es fertig für
amd64 und arm64. Konfigurationen, SQL und Manifeste im Buch tippst du
trotzdem selbst – das ist das Training.
Was du danach kannst
- PostgreSQL aus PGDG installieren, Rollen und Rechte nach dem Prinzip
der geringsten Rechte vergeben und den Zugang mit
pg_hba.conf, SCRAM und einer eigenen CA absichern. - Parameter samt Herkunft finden und wissen, ob ein Reload reicht oder ein Neustart nötig ist.
- Sperren, langsame Abfragen und Bloat finden, Ausführungspläne lesen und den passenden Index bauen.
- Mit
pg_stat_activity,pg_stat_statements, Logs und postgres_exporter sehen, was der Server tut. - Logisch und physisch sichern, ein Backup durch einen Restore beweisen und per Point-in-Time-Recovery auf die Sekunde vor dem Fehler zurückgehen.
- Einen Standby aufsetzen, Failover und Rücktausch mit
pg_rewinddurchführen, Tabellen logisch replizieren, Verbindungen mit PgBouncer bündeln und eine Major-Version upgraden. - Dasselbe mit CloudNativePG auf Kubernetes: Cluster anlegen, sichern, wiederherstellen, Ausfälle überstehen, überwachen und eine Anwendung anbinden.
Hinweis: Dieses Buch ist ein unabhängiges Übungsbuch. Es steht in keiner Verbindung zur PostgreSQL Global Development Group, zur PostgreSQL Community Association of Canada oder zum CloudNativePG-Projekt und wird von ihnen weder geprüft noch unterstützt. PostgreSQL ist eine Marke der PostgreSQL Community Association of Canada.
Versionen
| Komponente | Version | ab Tag |
|---|---|---|
| Ubuntu (pg1, pg2) | 24.04.5 LTS | 0 |
| PostgreSQL (PGDG) | 18.7 | 0 |
| pg_repack | 1.5.3 | 6 |
| postgres_exporter | 0.21.1 | 7 |
| pgBackRest | 2.60.1 | 9 |
| PgBouncer (PGDG) | 1.26.1 | 12 |
| PostgreSQL 17 (Ausgangsversion für das Upgrade) | 17.12 | 13 |
Kubernetes (Labor-Cluster ost) |
v1.37.2 | 14 |
| Helm | v4.3.2 | 14 |
| cert-manager | v1.21.3 | 14 |
cmctl |
2.6.2 | 14 |
| kube-prometheus-stack (Helm-Chart) | 93.4.1 | 14 |
CloudNativePG (Operator und kubectl cnpg) |
1.30.2 | 14 |
| PostgreSQL-Image für CloudNativePG | 18.7-minimal-trixie | 14 |
RustFS (S3 auf pg2) |
1.0.6 | 15 |
| Barman-Cloud-Plugin | 0.16.0 | 15 |
| PgBouncer-Image (CNPG-Pooler) | 1.26.1 | 17 |
| notes-api | 0.5.1 | 18 |
curlimages/curl |
8.17.0 | 18 |
Alle Ausgaben stammen aus echten Läufen, gekürzt, wo es sinnvoll ist.
Passwörter wie lab-notes-123 oder lab-repl-123
sind reine Lab-Werte – in Produktion gehören Passwörter in einen
Passwort-Tresor oder ein Secret, nie in ein Buch.
Viel Spaß im Trainingslager.