Mettre à jour ONLYOFFICE Docs sous Docker vers la dernière version

Introduction

Ce guide vous explique comment mettre à jour ONLYOFFICE Docs Édition Communauté version Docker vers la dernière version.

Avant la mise à jour, veuillez vérifier si votre version Docker répond aux exigences système minimales (toute version prise en charge par l'équipe Docker).

Avant de commencer

1. Sauvegarder vos données. Avant toute mise à jour, créez une sauvegarde de vos volumes de données montés afin de pouvoir les restaurer en cas de problème. Archivez les répertoires suivants:

   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. Notez votre version actuelle. Notez la version actuelle de l'image au cas où vous auriez besoin de revenir à une version précédente:

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

Arrêter ONLYOFFICE Docs

En raison des caractéristiques opérationnelles, ONLYOFFICE Docs n'enregistre un document qu'une fois le document a été fermé par tous les utilisateurs qui l'ont modifié. Pour éviter la perte de données, il faut déconnecter les utilisateurs ONLYOFFICE Docs lorsque vous devez arrêter ONLYOFFICE Docs en cas de mise à jour de l'application. Pour ce faire, exécutez le script suivant:

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

où {{DOCUMENT_SERVER_ID}} désigne le nom ou l'identifiant du conteneur ONLYOFFICE Docs.

Le nom ou l'identifiant du conteneur ONLYOFFICE Docs est visible après l'exécution de la commande Docker qui affiche tous les conteneurs existants:

sudo docker ps -a

Mettre à jour ONLYOFFICE Docs sous Docker

Mise à jour à l'aide du script

Si vous avez installé ONLYOFFICE Docs en utilisant le script, exécutez la commande suivante:

bash docs-install.sh -u true

Saisissez Y et appuyez sur Entrée pour mettre à jour ONLYOFFICE Docs à l'aide de Docker.

Mise à jour manuelle

Étape 1. Vérifier si tous les dossiers du stockage externe sont montés

Utilisez la commande suivante pour vérifier que tous les volumes du conteneur contenant les données ONLYOFFICE Docs soient montés:

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

Étape 2. Arrêter le conteneur actuel Docker ONLYOFFICE Docs.

sudo docker stop {{DOCUMENT_SERVER_ID}}

Étape 3. Télécharger la dernière image ONLYOFFICE Docs

Téléchargez la dernière image ONLYOFFICE Docs et indiquez le tag latest:

docker pull onlyoffice/documentserver:latest

Étape 4. Exécuter la nouvelle image avec le même mappage d'exécution au chemin d'accès

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

Veuillez vérifier que pendant l'exécution de la nouvelle image les chemins d'accès au dossier soient mappés exactement de la même manière que pendant le montage de la version précédente, sinon les données stockés dans ces dossiers ne seront pas reprises automatiquement. Pour ce faire, indiquez les arguments de l'option -v en remplaçant les valeurs /host_folder:/volume par des chemins d'accès actuels comme illustré à l'étape 1.

Si vous avez utilisé un autre port ou HTTPS pendant l'installation de la version précédente et si vous souhaitez installer la nouvelle version de la même façon, veuillez consulter les instructions d'installation pour rechercher des commendes nécessaires.

Une fois l'installation terminée, lancez ONLYOFFICE Docs et vérifiez le bon fonctionnement.

Étape 5 (facultatif): Supprimer le vieux conteneur et l'image ONLYOFFICE Docs

Une fois que vous avez testé minutieusement la nouvelle version et confirmé qu'elle fonctionne correctement, vous pouvez supprimer l'ancien conteneur ONLYOFFICE Docs. Ne supprimez pas l'ancien conteneur avant d'être certain de ne pas avoir besoin de revenir à une version précédente: Une fois le conteneur supprimé, la seule façon de restaurer la version précédente est de procéder à partir d'une sauvegarde.

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

où {{OLD_DOCUMENT_SERVER_CONTAINER_ID}} désigne le nom ou l'identifiant du conteneur OLD ONLYOFFICE Docs.

Si vous souhaitez libérer de l'espace, vous pouvez également supprimer la vieille image. Affichez toutes les images docker:

sudo docker images -a

Recherchez l'identifiant de l'image inutile dans la liste des images et supprimez-la:

sudo docker rmi {{OLD_DOCUMENT_SERVER_IMAGE_ID}}

Revenir à une version précédente

Si la version mise à jour ne fonctionne pas correctement et que vous n'avez pas encore supprimé l'ancien conteneur et l'ancienne image (consultez Étape 5), vous pouvez revenir à la version précédente:

1. Arrêtez le nouveau conteneur:

   sudo docker stop {{NEW_DOCUMENT_SERVER_ID}}

2. Démarrez l'ancien conteneur:

   sudo docker start {{OLD_DOCUMENT_SERVER_ID}}

3. Vérifiez que l'ancienne version fonctionne correctement.