Zum Inhalt springen
Trainingslager IT-Trainingslager

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 kommen generate_series und pgbench dazu.

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 list

multipass 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 kps im Namespace monitoring); 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 cp1 auf die Worker (Benutzer mit sudo) und crictl dort.
  • Tag 18: ein CNI, das NetworkPolicies durchsetzt; für Drill 8 Cilium samt cilium- und hubble-CLI und Hubble Relay (wie im Cilium-Buch). Ohne Cilium entfallen Hubble und die CiliumNetworkPolicy.
  • pg1, pg2 und der Cluster sollten sich gegenseitig im Netz erreichen: In Tag 14 verbindet sich pg2 von außen mit dem Cluster, in Tag 17 holt sich Prometheus Metriken von pg1.

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_rewind durchfü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.