Pular para o conteúdo principal

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 a 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.

Funcionalidades

  • 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

Consulte 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. O Podman é uma ferramenta para executar e gerenciar contêineres Linux.

Requisitos de sistema​

  • CPU: dual core 2 GHz ou melhor
  • RAM: 4 GB ou mais
  • HDD: pelo menos 40 GB de espaço livre
  • SWAP: pelo menos 4 GB, mas depende do sistema operacional host. Mais é melhor
  • OS: distribuição Linux amd64 com versão de kernel 3.10 ou posterior

Instalando o ONLYOFFICE Docs​

observação

Você precisa ter a versão mais recente do Podman instalada. Caso ainda não a possua, 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 na 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
observação

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}
observação

Ao copiar certificados sem entrar no contêiner, você precisa usar sudo (pois 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 do usuário ds no contêiner).

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

Clone o repositório do ONLYOFFICE Docs, acesse 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
observação

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 o 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/Data:Z  \
 -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice:Z \
 -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql:Z localhost/onlyofficeds:buildah

Registrando a sua versão Developer Edition​

Se você comprou o Developer Edition e recebeu o arquivo license.lic, 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 (por exemplo, /app/onlyoffice/DocumentServer/data/license.lic), mas você precisará montar essa pasta quando o contêiner for iniciado:

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

Depois disso, a sua versão do Developer Edition será registrada e completa.