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 o lançamento (release) estável mais recente.

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

Desligando o ONLYOFFICE Docs com segurança

Devido à sua arquitetura colaborativa, o ONLYOFFICE Docs consolida e salva um documento em disco apenas depois que ele é fechado por todos os usuários que o estavam editando simultaneamente. Para evitar qualquer perda de dados em trânsito, você deve desconectar forçadamente os usuários e preparar o serviço antes de interromper o contêiner para a atualização.

Para fazer isso, execute o seguinte script de preparação diretamente no seu host:

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

Nota: Substitua {{DOCUMENT_SERVER_ID}} pelo nome ou ID real do seu contêiner ativo do ONLYOFFICE Docs.

Se você não sabe o ID do contêiner, liste todos os contêineres ativos usando o comando padrão do Docker:

sudo docker ps -a

Atualizando o ONLYOFFICE Docs no Docker

Método 1: Atualizando via script automático

Se a sua versão atual do ONLYOFFICE Docs foi instalada utilizando o script automático fornecido, você pode atualizá-la executando o comando original acrescido da flag de update (-u true):

bash docs-enterprise-install.sh -u true

Digite Y e pressione Enter quando solicitado para confirmar a atualização via Docker.

Método 2: Atualização manual (Passo a passo)

Passo 1: Fazer backup dos mapeamentos de volume.
Antes de apagar o contêiner antigo, certifique-se de saber exatamente quais pastas físicas estão armazenando os dados persistentes. Verifique os caminhos executando o inspetor:

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

Passo 2: Parar o contêiner atual.
Após o script de shutdown (executado na seção anterior) ter finalizado com sucesso, interrompa o serviço:

sudo docker stop {{DOCUMENT_SERVER_ID}}

Passo 3: Baixar a nova imagem do ONLYOFFICE.
Puxe a imagem corporativa mais recente direto do repositório oficial especificando a tag latest:

sudo docker pull onlyoffice/documentserver-ee:latest

Passo 4: Executar o novo contêiner.
Inicialize a nova imagem garantindo que os mapeamentos de volume (argumentos -v) sejam exatamente os mesmos levantados no Passo 1. Se você errar o mapeamento, o novo contêiner subirá em branco e não encontrará seus dados antigos.

sudo docker run -i -t -d -p 80:80 --restart=always \
 -v /pasta_hospedeiro_logs:/var/log/onlyoffice \
 -v /pasta_hospedeiro_data:/var/www/onlyoffice/Data \
 -v /pasta_hospedeiro_lib:/var/lib/onlyoffice \
 -v /pasta_hospedeiro_db:/var/lib/postgresql \
 -e JWT_SECRET=seu_segredo_jwt_aqui \
 onlyoffice/documentserver-ee:latest

Lembrete: Se você instalou a versão anterior usando conexões seguras HTTPS ou portas personalizadas, certifique-se de recriar o comando de execução com esses mesmos parâmetros essenciais consultando as instruções de instalação originais.

Assim que o contêiner estiver online, abra a aplicação no navegador e verifique seu funcionamento correto.

Passo 5 (Opcional): Limpeza do ambiente.
Após certificar-se de que a sua versão atualizada funciona de forma impecável, você pode remover o contêiner antigo para liberar espaço:

sudo docker rm {{ID_DO_CONTEINER_ANTIGO}}

Para remover também a imagem Docker desatualizada, liste-as e apague pelo ID da imagem correspondente:

sudo docker images -a
sudo docker rmi {{ID_DA_IMAGEM_ANTIGA}}