Actualización de ONLYOFFICE Docs para Docker a la última versión

Introducción

Esta guía le mostrará cómo actualizar su versión Docker de ONLYOFFICE Docs Community Edition a la última versión.

Antes de actualizar, asegúrese de que su versión de Docker cumpla con los requisitos del sistema (cualquier versión soportada por el equipo de Docker).

Antes de comenzar

1. Haga una copia de seguridad de sus datos. Antes de cualquier actualización, cree una copia de seguridad de sus volúmenes de datos montados para asegurarse de que puede recuperarlos si algo sale mal. Archive los siguientes directorios:

   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. Anote su versión actual. Registre la versión actual de la imagen en caso de que necesite revertir:

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

Apagando ONLYOFFICE Docs

Debido a la característica operativa, ONLYOFFICE Docs guarda un documento solo después de que todos los usuarios que lo editaron lo hayan cerrado. Para evitar la pérdida de datos, debe desconectar forzosamente a los usuarios de ONLYOFFICE Docs cuando necesite detener ONLYOFFICE Docs en caso de actualización de la aplicación. Para hacerlo, ejecute el siguiente script:

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

donde {{DOCUMENT_SERVER_ID}} representa el nombre o ID del contenedor de ONLYOFFICE Docs.

Puede averiguar fácilmente el nombre o ID actual del contenedor de ONLYOFFICE Docs usando el comando Docker, que listará todos los contenedores existentes:

sudo docker ps -a

Actualizando ONLYOFFICE Docs para Docker

Actualización usando el script

Si su versión de ONLYOFFICE Docs fue instalada usando el siguiente script, ejecute el siguiente comando:

bash docs-install.sh -u true

Escriba Y y presione Enter para actualizar ONLYOFFICE Docs usando Docker.

Actualización manual

Paso 1: Verifique si todas las carpetas de almacenamiento de datos externas están montadas

Asegúrese de que todos los volúmenes del contenedor utilizados para almacenar datos de ONLYOFFICE Docs estén montados usando el siguiente comando:

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

Paso 2: Detenga el contenedor Docker actual de ONLYOFFICE Docs.

sudo docker stop {{DOCUMENT_SERVER_ID}}

Paso 3: Descargue la última imagen de ONLYOFFICE Docs

Descargue la última imagen de ONLYOFFICE Docs especificando la etiqueta latest:

docker pull onlyoffice/documentserver:latest

Paso 4: Ejecute la nueva imagen con las mismas rutas de mapeo

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         

Asegúrese de ejecutar la nueva imagen con las rutas de las carpetas mapeadas exactamente como se habían montado para la versión anterior, de lo contrario, los datos almacenados en estas carpetas no se recogerán automáticamente. Para hacerlo, especifique los argumentos de la opción -v reemplazando los valores /host_folder:/volume con las rutas reales como se mostraron en el Paso 1.

Si ha instalado la versión anterior usando un puerto diferente o HTTPS y desea instalar la nueva versión de la misma manera, consulte la siguiente instrucción de instalación para encontrar los comandos necesarios.

Una vez finalizado el proceso de instalación, ejecute ONLYOFFICE Docs y compruebe su correcto funcionamiento.

Paso 5 (Opcional): Elimine el contenedor y la imagen antiguos de ONLYOFFICE Docs

Después de haber probado exhaustivamente la nueva versión y confirmado que funciona correctamente, puede eliminar el contenedor antiguo de ONLYOFFICE Docs. No elimine el contenedor antiguo hasta estar seguro de que no necesitará volver atrás — una vez eliminado, la única forma de restaurar la versión anterior es desde una copia de seguridad.

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

donde {{OLD_DOCUMENT_SERVER_CONTAINER_ID}} representa el nombre o ID del contenedor ANTIGUO de ONLYOFFICE Docs.

Si desea liberar espacio, también puede eliminar una imagen antigua. Muestre todas las imágenes de docker:

sudo docker images -a

Encuentre el ID de la imagen innecesaria en la lista de imágenes y elimine la imagen:

sudo docker rmi {{OLD_DOCUMENT_SERVER_IMAGE_ID}}

Revertir a la versión anterior

Si la versión actualizada no funciona correctamente y aún no ha eliminado el contenedor y la imagen antiguos (vea el Paso 5), puede revertir:

1. Detenga el nuevo contenedor:

   sudo docker stop {{NEW_DOCUMENT_SERVER_ID}}

2. Inicie el contenedor antiguo:

   sudo docker start {{OLD_DOCUMENT_SERVER_ID}}

3. Verifique que la versión antigua esté funcionando correctamente.