Ab Version 44.0 startet compose.yaml PostgreSQL 18. Eine Installation, die mit einer früheren compose.yaml angelegt wurde, läuft auf PostgreSQL 17, und ihr erstes docker compose up -d auf 44.0 aktualisiert sie selbstständig. Notifuse läuft weiterhin auf PostgreSQL 17 (und lehnt ältere Server ab), Sie müssen also nicht umsteigen: siehe Bei PostgreSQL 17 bleiben.
Eine Installation mit externer Datenbank (DB_HOST zeigt auf ein verwaltetes PostgreSQL) ist nicht betroffen: Notifuse verbindet sich nur mit ihr.
Was docker compose up -d tut
- Compose hält Notifuse und PostgreSQL 17 an.
- Der Dienst
pg-upgradekopiert die Daten von PostgreSQL 17 in das Volumepostgres-upgrade-backupund ersetzt dabei eine frühere Kopie. Hat die Festplatte dieses Volumes weniger freien Platz als die Daten plus 10 %, hält er an, ohne etwas zu ändern, und der Stack startet nicht:docker compose logs pg-upgradenennt den benötigten Platz. Schaffen Sie Platz und führen Sie danndocker compose up -derneut aus. - Er aktualisiert die Daten an Ort und Stelle auf PostgreSQL 18, mit pgautoupgrade (
pg_upgrade --link). - PostgreSQL 18 startet auf den aktualisierten Daten, danach Notifuse.
Notifuse ist währenddessen nicht erreichbar. Die Dauer hängt mehr von der Zahl der Arbeitsbereiche ab als von der Datenmenge, weil jeder Arbeitsbereich eine eigene Datenbank hat: Sekunden für eine Handvoll Arbeitsbereiche, Minuten für Hunderte. Verfolgen Sie den Vorgang mit docker compose logs -f pg-upgrade.
Jedes spätere docker compose up -d findet die Daten auf 18 vor und tut nichts.
Bricht das Update auf halbem Weg ab (ein Fehler oder ein Ausfall des Servers), startet der Stack nicht; das nächste docker compose up -d spielt die Kopie zurück und beginnt das Update von vorn. docker compose logs pg-upgrade zeigt den Fehler des gescheiterten Versuchs.
Warnung
Die Kopie ist ein Rückweg auf derselben Festplatte, keine Sicherung. Erstellen Sie eine Sicherung, bevor Sie aktualisieren, und bewahren Sie SECRET_KEY mit der Sicherung auf.
Vor dem Update
-
Sichern Sie jede Datenbank, wie unter Sicherungen beschrieben.
-
Prüfen Sie den freien Platz: Die Kopie braucht so viel Platz, wie die Daten belegen. Bei laufendem Stack auf 17:
docker compose exec postgres du -sh /var/lib/postgresql/data df -h /var/lib/docker -
Setzen Sie
DB_EXPECT_EXISTING=truein.env. Sollte etwas schiefgehen und Notifuse eine leere Datenbank vorfinden, hält es dann an, statt darauf eine neue Installation zu beginnen.
Ergebnis prüfen
docker compose logs pg-upgrade | grep -i copy # "Copying the PostgreSQL 17 data ..." then "Copy done"
docker compose exec postgres psql -U postgres -d postgres -Atc "SELECT version()" # PostgreSQL 18.x
docker compose exec postgres psql -U postgres -d postgres -Atc "SELECT datname FROM pg_database ORDER BY 1"
Der letzte Befehl listet notifuse_system und eine Datenbank notifuse_ws_… pro Arbeitsbereich auf (ersetzen Sie postgres durch Ihren DB_USER, falls Sie ihn geändert haben). Melden Sie sich danach an und öffnen Sie Ihre Arbeitsbereiche.
Kopie löschen
Sobald die aktualisierte Installation funktioniert, löschen Sie die Kopie, um ihren Platz freizugeben. Ihr Name beginnt mit dem Compose-Projekt, also dem Namen des Verzeichnisses, das compose.yaml enthält:
docker volume ls | grep postgres-upgrade-backup
docker volume rm notifuse_postgres-upgrade-backup
Zurückkehren
Solange die Kopie existiert, können Sie zu PostgreSQL 17 und den Daten im Zustand vor dem Update zurückkehren. Alles, was seit dem Update geschrieben wurde, geht verloren.
docker compose down
# Put back the compose.yaml of your previous release, for example 43.0:
curl -fsSL https://raw.githubusercontent.com/Notifuse/notifuse/v43.0/compose.yaml -o compose.yaml
# Replace the PostgreSQL 18 data with the copy (project "notifuse": adjust both volume names)
docker run --rm -v notifuse_postgres-upgrade-backup:/from -v notifuse_postgres-data:/to alpine \
sh -c 'find /to -mindepth 1 -delete && cp -a /from/pg17/. /to/'
docker compose up -d
Bei PostgreSQL 17 bleiben
Behalten Sie in Ihrer compose.yaml Image und Mount-Pfad gemeinsam bei und entfernen Sie das Update:
image: postgres:17-alpineim Dienstpostgres;- sein Volume unter
/var/lib/postgresql/dataeingehängt (- postgres-data:/var/lib/postgresql/data); - den Dienst
pg-upgradeund dasdepends_onvonpostgresdarauf gelöscht.
Tag und Pfad gehören zusammen: PostgreSQL 18 legt seine Daten in /var/lib/postgresql/18/docker ab, 17 in /var/lib/postgresql/data.
Mit Ihrer eigenen Compose-Datei
Wenn Sie PostgreSQL aus Ihrer eigenen Datei starten, aktualisieren Sie auf dieselbe Weise: Stack anhalten, Sicherung erstellen, Volume kopieren und dann pgautoupgrade einmal darauf ausführen, eingehängt unter /var/lib/postgresql:
docker run --rm -v <your volume>:/var/lib/postgresql \
-e POSTGRES_USER=<your user> -e POSTGRES_PASSWORD=<your password> \
-e PGAUTO_ONESHOT=yes -e PGAUTO_REINDEX=no pgautoupgrade/pgautoupgrade:18-alpine
Verwenden Sie danach postgres:18-alpine mit dem Volume unter /var/lib/postgresql. PGAUTO_REINDEX=no ist nur sicher, wenn beide Images auf Alpine basieren; von einem Debian-basierten postgres:17 aus verwenden Sie pgautoupgrade:18-trixie ohne diese Option, damit die Indizes neu aufgebaut werden.
Warnung
Setzen Sie nie PGDATA, um einen Startfehler von PostgreSQL 18 zu umgehen. Mit einem ausdrücklich gesetzten PGDATA prüft das Image nicht mehr auf Daten einer älteren Version und legt neben Ihrer eine leere Datenbank an, statt den Start zu verweigern. Wenn PostgreSQL den Start verweigert, schützt diese Weigerung Ihre Daten.
Gut zu wissen
docker compose down -vunddocker volume prunelöschen die Datenbank und die Kopie.- Eine aktualisierte Datenbank behält die Datenprüfsummen ausgeschaltet, so wie PostgreSQL 17 sie angelegt hat; eine neue Installation von PostgreSQL 18 hat sie eingeschaltet.
- Aktualisieren Sie auf derselben CPU-Architektur, auf der die Datenbank angelegt wurde: Verbinden Sie einen Umzug zwischen x86- und ARM-Servern nicht mit dem Update.
- pgautoupgrade unterstützt keine PostgreSQL-Server mit aktiviertem SSL oder mit Tablespaces auf separaten Volumes;
compose.yamlverwendet beides nicht. Verschieben Sie die Daten in diesen Fällen stattdessen mit einer Sicherung und Wiederherstellung.
