Atualizando ONLYOFFICE Docs para Docker para a versão mais recente

Introdução

Este guia mostrará como atualizar sua versão Docker do ONLYOFFICE Docs Community Edition para a versão mais recente.

observação

Nossa política de suporte é que oferecemos suporte apenas à versão estável mais recente. Lançamos regularmente novas versões do ONLYOFFICE Docs que incluem novos recursos e correções de bugs. Se você estiver usando uma versão antiga do ONLYOFFICE Docs, recomendamos atualizar para a versão mais recente.

Importante

Se você estiver usando uma versão antiga do Integration Edition, a única maneira de atualizá-la é desinstalar o Integration Edition (onlyoffice/documentserver-ie) e instalar o Enterprise Edition em seu lugar.

Antes de atualizar, certifique-se de que sua versão do Docker corresponda aos requisitos do sistema (qualquer versão suportada pela equipe Docker).

Antes de começar

1. Faça backup dos seus dados. Antes de qualquer atualização, crie um backup dos volumes de dados montados para garantir que você possa recuperá-los se algo der errado. Arquive os seguintes diretórios:

   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 sua versão atual. Registre a versão atual da imagem caso precise voltar para a versão anterior:

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

Desligando ONLYOFFICE Docs

Devido à característica operacional, o ONLYOFFICE Docs salva um documento somente depois que o documento foi fechado por todos os usuários que o editaram. Para evitar perda de dados, você deve desconectar forçadamente os usuários do ONLYOFFICE Docs quando precisar parar o ONLYOFFICE Docs em caso de atualização do aplicativo. Para fazer isso, execute o seguinte script:

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

onde {{DOCUMENT_SERVER_ID}} representa o nome ou ID do container ONLYOFFICE Docs.

Você pode descobrir facilmente o nome ou ID atual do container ONLYOFFICE Docs usando o comando Docker, que listará todos os containers existentes:

sudo docker ps -a

observação

A execução do script pode levar muito tempo (até 5 minutos).

observação

A desconexão dos usuários pode levar muito tempo (até 5 minutos).

Atualizando ONLYOFFICE Docs para Docker

Atualizando usando o script

Se sua versão do ONLYOFFICE Docs foi instalada usando o seguinte script, execute o seguinte comando:

bash docs-install.sh -u true

Digite Y e pressione Enter para atualizar o ONLYOFFICE Docs usando Docker.

observação

A versão Docker do ONLYOFFICE Docs Community Edition será atualizada usando o script somente se a instalação foi executada anteriormente usando este script.

Atualizando manualmente

Etapa 1: Verifique se todas as pastas de armazenamento de dados externas estão montadas

Certifique-se de que todos os volumes do container usados para armazenar dados do ONLYOFFICE Docs estejam montados usando o seguinte comando:

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

Etapa 2: Pare o container Docker atual do ONLYOFFICE Docs.

sudo docker stop {{DOCUMENT_SERVER_ID}}

Etapa 3: Baixe a imagem mais recente do ONLYOFFICE Docs

Baixe a imagem mais recente do ONLYOFFICE Docs especificando a tag latest:

docker pull onlyoffice/documentserver:latest

Etapa 4: Execute a nova imagem com os mesmos caminhos de mapeamento

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

Certifique-se de executar a nova imagem com os caminhos de pasta mapeados exatamente como foram montados para a versão anterior, caso contrário, os dados armazenados nessas pastas não serão coletados automaticamente. Para fazer isso, especifique os argumentos da opção -v substituindo os valores /host_folder:/volume pelos caminhos reais conforme mostrado na Etapa 1.

Se você instalou a versão anterior usando uma porta diferente ou HTTPS e deseja instalar a nova versão da mesma maneira, consulte a seguinte instrução de instalação para encontrar os comandos necessários.

Assim que o processo de instalação terminar, execute o ONLYOFFICE Docs e verifique se está funcionando corretamente.

Etapa 5 (Opcional): Remova o container e a imagem antigos do ONLYOFFICE Docs

Depois de testar minuciosamente a nova versão e confirmar que ela funciona corretamente, você pode remover o container antigo do ONLYOFFICE Docs. Não remova o container antigo até ter certeza de que não precisará voltar para a versão anterior — depois de removido, a única maneira de restaurar a versão anterior é a partir de um backup.

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

onde {{OLD_DOCUMENT_SERVER_CONTAINER_ID}} representa o nome ou ID do container ANTIGO do ONLYOFFICE Docs.

Se você deseja liberar espaço, também pode remover uma imagem antiga. Exiba todas as imagens docker:

sudo docker images -a

Encontre o ID da imagem desnecessária na lista de imagens e remova a imagem:

sudo docker rmi {{OLD_DOCUMENT_SERVER_IMAGE_ID}}

Voltando para a versão anterior

Se a versão atualizada não estiver funcionando corretamente e você ainda não tiver removido o container e a imagem antigos (veja a Etapa 5), você pode voltar para a versão anterior:

1. Pare o novo container:

   sudo docker stop {{NEW_DOCUMENT_SERVER_ID}}

2. Inicie o container antigo:

   sudo docker start {{OLD_DOCUMENT_SERVER_ID}}

3. Verifique se a versão antiga está funcionando corretamente.

Importante

Voltar para a versão anterior só é possível se você manteve o container antigo (ou seja, não executou docker rm nele). É por isso que a Etapa 5 está marcada como opcional — não remova o container antigo até ter certeza de que a nova versão funciona.

observação

O esquema do banco de dados foi alterado na v6.3. Ao atualizar para v6.3 (se você usar a versão Docker do ONLYOFFICE Docs com um banco de dados externo), você também pode precisar atualizar o esquema do banco de dados para garantir a capacidade de usar o recurso de proteção por senha.

1. Localize o script para atualizar o esquema do banco de dados no contêiner do ONLYOFFICE Docs.

   • Para PostgreSQL: /var/www/onlyoffice/documentserver/server/schema/postgresql/upgrade/upgradev630.sql
   • Para MySQL: /var/www/onlyoffice/documentserver/server/schema/mysql/upgrade/upgradev630.sql

2. Execute o script usando a linha de comando.

   • Para PostgreSQL: psql -U onlyoffice -W onlyoffice < {path-to-upgradev630.sql}
   • Para MySQL: mysql -u root -p onlyoffice < {path-to-upgradev630.sql}

   Especifique a senha usada ao criar o banco de dados (onlyoffice).