Ein Update ersetzt das Notifuse-Image und startet es neu. Beim Start auf dem neuen Release aktualisiert Notifuse seine Datenbanken selbst.
Zuerst das Änderungsprotokoll lesen
Öffnen Sie das Änderungsprotokoll und lesen Sie jedes Release zwischen Ihrer Version und der neuen. Manche Releases haben einen Hinweis Vor dem Update mit einer Änderung, die Sie im selben Schritt wie das Update vornehmen, etwa einen neuen Wert für SECRET_KEY bei 42.0 oder WEBHOOK_DELIVERY_ALLOW_PRIVATE_HOSTS für Webhooks in Ihrem eigenen Netzwerk.
Ist Nach Updates suchen eingeschaltet, sehen der Root-Benutzer und die Inhaber von Arbeitsbereichen in der Liste der Arbeitsbereiche eine Karte, sobald ein neues Release erschienen ist. Ihre Schaltfläche Neuerungen ansehen zeigt jedes Release seit Ihrem, jeweils mit seinen Hinweisen Vor dem Update: und einem Link Vollständiges Änderungsprotokoll.
Sicherung erstellen
Sichern Sie jede Datenbank und bewahren Sie SECRET_KEY zusammen mit den Dumps auf, wie unter Sicherungen beschrieben. Eine Rückkehr zu einer früheren Hauptversion braucht diese Sicherung (siehe Zurückkehren).
Setzen Sie DB_EXPECT_EXISTING=true in .env, falls es dort noch nicht steht. Sollte Notifuse nach dem Update je eine leere Datenbank vorfinden, hält es dann an, statt eine neue Installation zu beginnen.
Mit Docker Compose aktualisieren
compose.yaml entnimmt das Release aus NOTIFUSE_VERSION:
image: notifuse/notifuse:${NOTIFUSE_VERSION:-v44.0}
Der Standardwert nach :- ist das Release, mit dem die Datei veröffentlicht wurde. Wählen Sie einen der beiden Wege, um ihn zu ändern, jeweils im Verzeichnis, das compose.yaml enthält.
Version in .env festlegen
Tragen Sie das neue Release in .env ein, laden Sie dann das Image und starten Sie neu:
# In .env: NOTIFUSE_VERSION=v44.0
docker compose pull
docker compose up -d Neue compose.yaml herunterladen
Ersetzen Sie Ihre compose.yaml durch die aktuelle, laden Sie dann das Image und starten Sie neu. Ihre .env bleibt, wie sie ist. Übertragen Sie eigene Änderungen an compose.yaml in die neue Datei.
curl -fsSL https://raw.githubusercontent.com/Notifuse/notifuse/main/compose.yaml -o compose.yaml
docker compose pull
docker compose up -dSetzt .env die Variable NOTIFUSE_VERSION, hat dieser Wert Vorrang vor dem Standardwert in der Datei: Passen Sie ihn ebenfalls an.
docker compose pull lädt das neue Image herunter, während das alte weiterläuft. docker compose up -d ersetzt dann den Container. Notifuse hat bis zu 70 Sekunden Zeit zum Beenden: Der laufende Automatisierungsschritt und die gerade gesendeten E-Mails werden zuerst abgeschlossen.
Um vor dem Neustart zu prüfen, welches Release Compose ausführen wird, sehen Sie sich das aufgelöste Image an:
docker compose config | grep 'image: notifuse'
Hinweis
Bis 43.0 baut compose.yaml Notifuse aus dem Klon des Repositorys, in dem die Datei liegt. Checken Sie in einem solchen Klon das neue Release aus (git fetch --tags && git checkout v44.0) und führen Sie dann docker compose up -d aus. Ab 44.0 startet die Datei das veröffentlichte Image, außer Sie übergeben --build.
Was beim Start passiert
Wenn das neue Release startet, führt Notifuse seine Datenbankmigrationen aus, bevor es eine Anfrage beantwortet:
- Es prüft die PostgreSQL-Version. Seit 44.0 startet es nicht auf PostgreSQL älter als 17 und nennt die gefundene Version.
- Es vergleicht die in der Systemdatenbank erfasste Hauptversion (
43für 43.0) mit seiner eigenen. - Es wendet jede dazwischenliegende Migration auf die Systemdatenbank an, dann auf jede Datenbank eines Arbeitsbereichs.
- Es erfasst die neue Version. Bei manchen Migrationen beendet sich Notifuse danach einmal, und Docker startet es wieder (
restart: unless-stopped).
Laufen mehrere Instanzen auf derselben Datenbank, wendet eine die Migrationen an und die anderen warten auf sie (ab 42.2). Den Fortschritt verfolgen Sie im Log:
docker compose logs -f api
Das Log schließt diesen Schritt mit Migration process completed successfully ab, oder mit Database is up to date, no migrations needed, wenn sich die Hauptversion nicht geändert hat. Schlägt eine Migration fehl, startet Notifuse nicht, und das Log nennt sie: migration failed for version ….
Version prüfen
Melden Sie sich an und öffnen Sie die Liste der Arbeitsbereiche. Ihre Fußzeile zeigt die laufende Version, etwa Notifuse v44.0. Auch das Kontomenü zeigt sie.
Auf der Kommandozeile finden Sie sie in der Konfigurationsdatei der Konsole:
curl -s https://emails.yourcompany.com/config.js | grep VERSION
Prüfen Sie dann, ob https://emails.yourcompany.com/healthz mit {"status":"ok"} antwortet, und öffnen Sie einen Arbeitsbereich, um Ihre Daten zu kontrollieren.
Zurückkehren
Notifuse erfasst in der Datenbank nur die Hauptversion und hat keine Down-Migrationen.
Innerhalb derselben Hauptversion (zum Beispiel von 44.1 zurück auf 44.0) setzen Sie das vorherige Release in NOTIFUSE_VERSION und führen docker compose up -d aus. Notifuse startet auf derselben Datenbank.
Über Hauptversionen hinweg startet das ältere Release nicht auf einer Datenbank, die das neuere migriert hat. Das Log meldet database is at version 44, this build is version 43 - refusing to start. So kehren Sie zurück:
- Halten Sie den Stack mit
docker compose downan. - Setzen Sie das vorherige Release in
NOTIFUSE_VERSIONoder stellen Sie dessencompose.yamlwieder her. - Spielen Sie die vor dem Update erstellte Sicherung in eine leere Datenbank ein, wie unter Wiederherstellen beschrieben, mit dem
SECRET_KEY, mit dem die Sicherung erstellt wurde.
Alles, was seit der Sicherung geschrieben wurde, geht verloren.
War es das Update auf 44.0, das auch PostgreSQL auf 18 umstellt, verwenden Sie stattdessen die Kopie, die compose.yaml aufbewahrt: Zurückkehren stellt die PostgreSQL-17-Daten im Zustand vor dem Update wieder her, mit der compose.yaml des vorherigen Releases.
PostgreSQL aktualisieren
Version 44.0 stellt compose.yaml von PostgreSQL 17 auf 18 um, und das erste docker compose up -d damit aktualisiert auch die Datenbank. PostgreSQL aktualisieren erklärt, was dabei passiert, wie viel Speicherplatz es braucht, wie Sie das Ergebnis prüfen und wie Sie zurückkehren.
