Atualizando o ONLYOFFICE Docs Enterprise Edition no Docker

Introdução

Este guia demonstrará como atualizar a versão Docker do seu ONLYOFFICE Docs Enterprise Edition para a versão mais recente.

observação

A ONLYOFFICE garante suporte técnico oficial apenas para a 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ê ainda estiver usando uma versão legada da Integration Edition, a única maneira de atualizá-la é desinstalar a Integration Edition (onlyoffice/documentserver-ie) e instalar a Enterprise Edition no seu lugar.

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

Desligando o ONLYOFFICE Docs

Devido à sua característica operacional, o ONLYOFFICE Docs salva um documento apenas depois que ele é fechado por todos os usuários que o estavam editando. Para evitar a perda de dados, você deve desconectar forçadamente os usuários do ONLYOFFICE Docs quando precisar interromper o ONLYOFFICE Docs para a atualização do aplicativo. Para fazer isso, execute o seguinte script:

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

onde {{DOCUMENT_SERVER_ID}} é o nome ou ID do contêiner do ONLYOFFICE Docs.

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

sudo docker ps -a

observação

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

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

Atualizando o ONLYOFFICE Docs no Docker

Atualizando via script

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

bash docs-enterprise-install.sh -u true

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

observação

A versão Docker do ONLYOFFICE Docs Enterprise Edition será atualizada via script apenas se a instalação anterior também tiver sido feita usando este script.

Atualização manual

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

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

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

Passo 2: Pare o contêiner Docker atual do ONLYOFFICE Docs.

sudo docker stop {{DOCUMENT_SERVER_ID}}

Passo 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-ee:latest

Passo 4: Execute a nova imagem com os mesmos mapeamentos de caminho

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

Certifique-se de executar a nova imagem com os caminhos de pasta mapeados exatamente como estavam montados na versão anterior; caso contrário, os dados armazenados nessas pastas não serão encontrados automaticamente. Para isso, especifique os argumentos da opção -v, substituindo os valores /host_folder:/volume pelos caminhos reais mostrados no Passo 1.

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

Quando o processo de instalação terminar, execute o ONLYOFFICE Docs e verifique se ele funciona corretamente.

Passo 5 (Opcional): Remova o contêiner e a imagem antigos do ONLYOFFICE Docs

Depois de verificar que tudo está certo e que a sua versão atualizada do ONLYOFFICE Docs funciona corretamente, você pode remover o contêiner antigo do ONLYOFFICE Docs:

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

onde {{OLD_DOCUMENT_SERVER_CONTAINER_ID}} é o nome ou ID do contêiner ANTIGO do ONLYOFFICE Docs.

Se quiser liberar espaço, você também pode remover a imagem antiga. Liste 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}}

observação

O esquema do banco de dados mudou na versão 6.3. Ao atualizar para a versão 6.3 (se você usa a versão Docker do ONLYOFFICE Docs com um banco de dados externo), talvez seja necessário atualizar também o esquema do banco de dados para garantir a funcionalidade do 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 utilizada ao criar o banco de dados (onlyoffice).