Executando o ONLYOFFICE Docs Developer Edition com Podman no Fedora

Introdução

O Developer Edition permite que você instale o ONLYOFFICE Docs em seu servidor local e integre os editores online com sua aplicação web.

O ONLYOFFICE Docs é um pacote office online que compreende visualizadores e editores para textos, planilhas e apresentações, totalmente compatível com os formatos Office Open XML (.docx, .xlsx, .pptx) e permite a edição colaborativa em tempo real.

Funcionalidade

Document Editor
Spreadsheet Editor
Presentation Editor
Visualizadores web móveis
Editores web móveis
Edição colaborativa
Suporte a hieróglifos
Suporte para todos os formatos populares: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML

Veja a lista detalhada de recursos disponíveis para o ONLYOFFICE Docs Developer Edition.

Este guia mostrará como instalar a versão Linux do ONLYOFFICE Docs Developer Edition com Podman no Fedora. Podman é uma ferramenta para executar e gerenciar contêineres Linux.

Requisitos de sistema

CPU

dual core de 2 GHz ou superior
RAM

4 GB ou mais
HDD

pelo menos 40 GB de espaço livre
SWAP

pelo menos 4 GB, mas depende do SO host. Quanto mais, melhor
SO

Distribuição Linux amd64 com versão de kernel 3.10 ou posterior

Instalando o ONLYOFFICE Docs

Você precisa da versão mais recente do Podman instalada. Caso não a tenha, consulte a seção de Instalação no site do Podman para saber como obtê-la.

Executando o ONLYOFFICE Docs com Podman como usuário root

Crie novas pastas para armazenar os dados do contêiner em sua máquina host:

sudo mkdir -p /app/onlyoffice/DocumentServer/logs \
 /app/onlyoffice/DocumentServer/data \
 /app/onlyoffice/DocumentServer/lib \
 /app/onlyoffice/DocumentServer/db

Agora monte esses diretórios via Podman e execute o ONLYOFFICE Docs usando o seguinte comando:

sudo podman run -i -t -d -p 80:80 -p 443:443 --restart=always \
 -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice:Z  \
 -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data:Z  \
 -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice:Z \
 -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql:Z \
 -u root onlyoffice/documentserver-de:latest

Observe que a implantação rootless (sem privilégios de root) NÃO é recomendada para o ONLYOFFICE Docs.

Para verificar se o ONLYOFFICE Docs está funcionando corretamente, execute este comando:

sudo podman exec $(sudo podman ps -q) sudo supervisorctl start ds:example

Em seguida, abra um navegador, acesse http://localhost/welcome e clique no botão GO TO TEST EXAMPLE. Você será direcionado para uma página onde poderá criar documentos com conteúdo de exemplo.

Mudando o ONLYOFFICE Docs para HTTPS

Instale os certificados onlyoffice.key e onlyoffice.crt em seu servidor e reinicie o contêiner do ONLYOFFICE Docs usando os seguintes comandos:

sudo mkdir /app/onlyoffice/DocumentServer/data/certs
sudo cp onlyoffice.crt /app/onlyoffice/DocumentServer/data/certs/
sudo cp onlyoffice.key /app/onlyoffice/DocumentServer/data/certs/
sudo chown -R 100108:100111 /app/onlyoffice/DocumentServer/data/certs/
sudo podman restart {container_id}

Ao copiar certificados sem entrar no contêiner, você precisa usar sudo (já que o contêiner foi iniciado por um usuário não root) e, em seguida, alterar o proprietário do arquivo para o usuário 100108 100111 (este é o subuid ds do usuário no contêiner).

Construindo a imagem do ONLYOFFICE Docs no Podman como usuário root

Clone o repositório do ONLYOFFICE Docs, vá para a pasta Docker-DocumentServer e construa a imagem usando os seguintes comandos:

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer.git
cd Docker-DocumentServer/
sudo podman build --tag onlyofficeds:podman -f ./Dockerfile

Construindo a imagem do ONLYOFFICE Docs a partir do Dockerfile com Buildah como usuário root

Use o seguinte comando:

buildah bud --tag onlyofficeds:buildah -f ./Dockerfile

O Buildah suporta a construção de imagens sem permissões de root, mas a construção da imagem do ONLYOFFICE Docs a partir do Dockerfile com o Buildah funciona apenas com acesso root.

Executando o contêiner do ONLYOFFICE Docs a partir de um diretório local sem permissões de root

Após construir a imagem do ONLYOFFICE Docs com Buildah conforme descrito acima, execute o contêiner do ONLYOFFICE Docs usando o seguinte comando:

podman run -i -t -d -p 8003:80 -p 4430:443 --restart=always \
 -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice:Z  \
 -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice:Z  \
 -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice:Z \
 -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql:Z localhost/onlyofficeds:buildah

Registrando sua versão Developer Edition

Se você comprou o Developer Edition e recebeu o arquivo license.lic, você pode colocá-lo em sua instalação para obter a versão completa do software.

Ao usar o contêiner Podman, o arquivo license.lic pode ser colocado em qualquer pasta (ex: /app/onlyoffice/DocumentServer/data/license.lic), mas você precisará montar esta pasta quando o contêiner iniciar:

podman run -i -t -d -p 80:80 -p 443:443 --restart=always \
 -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice:Z  \
 -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice:Z  \
 -v /onlyoffice/DocumentServer/lib:/var/lib/onlyoffice:Z \
 -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql:Z \
 -/documentserver-de:latest

Depois disso, sua versão do Developer Edition se tornará registrada e completa.