Aggiornamento di ONLYOFFICE Docs per Docker all'ultima versione

Introduzione

Questa guida ti mostrerà come aggiornare la versione Docker di ONLYOFFICE Docs Community Edition all'ultima versione.

Prima di aggiornare, assicurati che la tua versione di Docker corrisponda ai requisiti di sistema (qualsiasi versione supportata dal team Docker).

Prima di iniziare

1. Esegui il backup dei tuoi dati. Prima di qualsiasi aggiornamento, crea un backup dei tuoi volumi di dati montati per assicurarti di poter recuperare i dati se qualcosa va storto. Archivia le seguenti directory:

   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. Annota la tua versione attuale. Registra la versione attuale dell'immagine nel caso in cui sia necessario tornare indietro:

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

Spegnimento di ONLYOFFICE Docs

A causa delle caratteristiche operative, ONLYOFFICE Docs salva un documento solo dopo che è stato chiuso da tutti gli utenti che lo hanno modificato. Per evitare la perdita di dati, devi disconnettere forzatamente gli utenti di ONLYOFFICE Docs quando devi fermare ONLYOFFICE Docs in caso di aggiornamento dell'applicazione. Per farlo, esegui il seguente script:

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

dove {{DOCUMENT_SERVER_ID}} rappresenta il nome o l'ID del container di ONLYOFFICE Docs.

Puoi facilmente trovare il nome o l'ID attuale del container di ONLYOFFICE Docs utilizzando il comando Docker, che elencherà tutti i container esistenti:

sudo docker ps -a

Aggiornamento di ONLYOFFICE Docs per Docker

Aggiornamento tramite script

Se la tua versione di ONLYOFFICE Docs è stata installata utilizzando il seguente script, esegui il seguente comando:

bash docs-install.sh -u true

Digita Y e premi Invio per aggiornare ONLYOFFICE Docs utilizzando Docker.

Aggiornamento manuale

Passo 1: Verifica se tutte le cartelle di archiviazione dati esterne sono montate

Assicurati che tutti i volumi del container utilizzati per archiviare i dati di ONLYOFFICE Docs siano montati utilizzando il seguente comando:

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

Passo 2: Arresta il container Docker corrente di ONLYOFFICE Docs.

sudo docker stop {{DOCUMENT_SERVER_ID}}

Passo 3: Scarica l'ultima immagine di ONLYOFFICE Docs

Scarica l'ultima immagine di ONLYOFFICE Docs specificando il tag latest:

docker pull onlyoffice/documentserver:latest

Passo 4: Esegui la nuova immagine con gli stessi percorsi mappati

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         

Assicurati di eseguire la nuova immagine con i percorsi delle cartelle mappati esattamente come erano stati montati per la versione precedente, altrimenti i dati memorizzati in queste cartelle non verranno rilevati automaticamente. Per farlo, specifica gli argomenti dell'opzione -v sostituendo i valori /host_folder:/volume con i percorsi effettivi come mostrato nel Passo 1.

Se hai installato la versione precedente utilizzando una porta diversa o HTTPS e desideri installare la nuova versione nello stesso modo, consulta le seguenti istruzioni di installazione per trovare i comandi necessari.

Una volta completato il processo di installazione, esegui ONLYOFFICE Docs e verifica che funzioni correttamente.

Passo 5 (Opzionale): Rimuovi il vecchio container e l'immagine di ONLYOFFICE Docs

Dopo aver testato a fondo la nuova versione e confermato che funziona correttamente, puoi rimuovere il vecchio container di ONLYOFFICE Docs. Non rimuovere il vecchio container finché non sei sicuro di non dover tornare indietro — una volta rimosso, l'unico modo per ripristinare la versione precedente è da un backup.

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

dove {{OLD_DOCUMENT_SERVER_CONTAINER_ID}} rappresenta il nome o l'ID del container VECCHIO di ONLYOFFICE Docs.

Se desideri liberare spazio, puoi anche rimuovere una vecchia immagine. Visualizza tutte le immagini docker:

sudo docker images -a

Trova l'ID dell'immagine non necessaria nell'elenco delle immagini e rimuovi l'immagine:

sudo docker rmi {{OLD_DOCUMENT_SERVER_IMAGE_ID}}

Tornare alla versione precedente

Se la versione aggiornata non funziona correttamente e non hai ancora rimosso il vecchio container e l'immagine (vedi Passo 5), puoi tornare indietro:

1. Arresta il nuovo container:

   sudo docker stop {{NEW_DOCUMENT_SERVER_ID}}

2. Avvia il vecchio container:

   sudo docker start {{OLD_DOCUMENT_SERVER_ID}}

3. Verifica che la vecchia versione funzioni correttamente.