ONLYOFFICE Docs Community Edition für Docker auf die neueste Version aktualisieren

Einleitung

Diese Anleitung zeigt Ihnen, wie Sie Ihre Docker-Version von ONLYOFFICE Docs Community Edition auf die neueste Version aktualisieren.

Stellen Sie vor der Aktualisierung sicher, dass Ihre Docker-Version den Systemanforderungen entspricht (jede vom Docker-Team unterstützte Version).

Bevor Sie beginnen

1. Sichern Sie Ihre Daten. Erstellen Sie vor jedem Update eine Sicherungskopie Ihrer gemounteten Daten-Volumes, damit Sie diese im Fehlerfall wiederherstellen können. Archivieren Sie die folgenden Verzeichnisse:

   sudo tar -czf onlyoffice-docs-backup-$(date +%Y%m%d).tar.gz \
       /app/onlyoffice/DocumentServer/data \
       /app/onlyoffice/DocumentServer/lib \
       /app/onlyoffice/DocumentServer/db

2. Notieren Sie Ihre aktuelle Version. Halten Sie die aktuelle Image-Version fest, falls Sie ein Rollback durchführen müssen:

   sudo docker inspect --format='{{.Config.Image}}' {{DOCUMENT_SERVER_ID}}

ONLYOFFICE Docs herunterfahren

Aufgrund der Funktionsweise speichert ONLYOFFICE Docs ein Dokument erst, nachdem es von allen Benutzern, die es bearbeitet haben, geschlossen wurde. Um Datenverlust zu vermeiden, müssen Sie die Verbindung der ONLYOFFICE Docs-Benutzer zwangsweise trennen, wenn Sie ONLYOFFICE Docs im Falle eines Anwendungsupdates beenden müssen. Führen Sie dazu das folgende Skript aus:

sudo docker exec {{DOCUMENT_SERVER_ID}} documentserver-prepare4shutdown.sh

wobei {{DOCUMENT_SERVER_ID}} für den Containernamen oder die ID von ONLYOFFICE Docs steht.

Sie können den aktuellen Containernamen oder die ID von ONLYOFFICE Docs ganz einfach mit dem Docker-Befehl herausfinden, der alle vorhandenen Container auflistet:

sudo docker ps -a

ONLYOFFICE Docs für Docker aktualisieren

Aktualisierung mit dem Skript

Wenn Ihre ONLYOFFICE Docs-Version mit dem folgenden Skript installiert wurde, führen Sie den folgenden Befehl aus:

bash docs-install.sh -u true

Geben Sie Y ein und drücken Sie die Eingabetaste, um ONLYOFFICE Docs mit Docker zu aktualisieren.

Manuelle Aktualisierung

Schritt 1: Überprüfen Sie, ob alle externen Datenspeicherordner gemountet sind

Stellen Sie sicher, dass alle Container-Volumes, die zum Speichern von ONLYOFFICE Docs-Daten verwendet werden, mit dem folgenden Befehl gemountet sind:

sudo docker inspect --format='{{range $p,$conf:=.HostConfig.Binds}}{{$conf}};{{end}}' {{DOCUMENT_SERVER_ID}}

Schritt 2: Stoppen Sie den aktuellen ONLYOFFICE Docs-Docker-Container

sudo docker stop {{DOCUMENT_SERVER_ID}}

Schritt 3: Laden Sie das neueste ONLYOFFICE Docs-Bild herunter

Laden Sie das neueste ONLYOFFICE Docs-Bild herunter und geben Sie das Tag latest an:

docker pull onlyoffice/documentserver:latest

Schritt 4: Führen Sie das neue Bild mit denselben Map-Pfaden aus

sudo docker run -i -t -d -p 80:80 --restart=always \
                -v /host_folder:/volume \
                -v /host_folder:/volume -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver
            

Stellen Sie sicher, dass Sie das neue Image mit den exakt zugeordneten Ordnerpfaden ausführen, die in der vorherigen Version bereitgestellt wurden. Andernfalls werden die in diesen Ordnern gespeicherten Daten nicht automatisch abgerufen. Geben Sie dazu die Argumente der Option -v an, indem Sie die Werte von /host_folder:/volume durch die tatsächlichen Pfade ersetzen, wie sie in Schritt 1 angezeigt wurden.

Wenn Sie die vorherige Version über einen anderen Port oder HTTPS installiert haben und die neue Version auf die gleiche Weise installieren möchten, finden Sie die erforderlichen Befehle in der folgenden Installationsanleitung.

Sobald der Installationsvorgang abgeschlossen ist, führen Sie ONLYOFFICE Docs aus und überprüfen Sie, ob es korrekt funktioniert.

Schritt 5 (Optional): Entfernen Sie den alten ONLYOFFICE Docs-Container und das Bild

Nachdem Sie die neue Version gründlich getestet und sichergestellt haben, dass sie korrekt funktioniert, können Sie den alten ONLYOFFICE Docs-Container entfernen. Entfernen Sie den alten Container erst, wenn Sie sicher sind, dass kein Rollback mehr erforderlich ist — nach dem Entfernen ist die einzige Möglichkeit zur Wiederherstellung der vorherigen Version eine Sicherungskopie.

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

wobei {{OLD_DOCUMENT_SERVER_CONTAINER_ID}} für den ALTEN ONLYOFFICE Docs-Containernamen oder die ID steht.

Wenn Sie Speicherplatz freigeben möchten, können Sie auch ein altes Bild entfernen. Um alle Docker-Bilder anzuzeigen:

sudo docker images -a

Suchen Sie in der Bilderliste nach der unnötigen Bild-ID und entfernen Sie das Bild:

sudo docker rmi {{OLD_DOCUMENT_SERVER_IMAGE_ID}}

Zurücksetzen auf die vorherige Version

Wenn die aktualisierte Version nicht korrekt funktioniert und Sie den alten Container und das alte Image noch nicht entfernt haben (siehe Schritt 5), können Sie ein Rollback durchführen:

1. Stoppen Sie den neuen Container:

   sudo docker stop {{NEW_DOCUMENT_SERVER_ID}}

2. Starten Sie den alten Container:

   sudo docker start {{OLD_DOCUMENT_SERVER_ID}}

3. Überprüfen Sie, ob die alte Version korrekt funktioniert.