Instalando o ONLYOFFICE Docs Enterprise Edition com Podman no Fedora

Introdução

A partir da versão 7.1, o ONLYOFFICE Docs possui suporte para ser provisionado nativamente utilizando o Podman em infraestruturas com arquitetura ARM de 64 bits.

A Enterprise Edition permite que você instale o ONLYOFFICE Docs em seu servidor corporativo local e integre os editores online com a plataforma de colaboração da ONLYOFFICE ou com outros sistemas populares.

O ONLYOFFICE Docs é um pacote office online de alto desempenho 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 segura em tempo real.

Principais Funcionalidades:

• Document Editor, Spreadsheet Editor e Presentation Editor
• Visualizadores e editores web otimizados para dispositivos móveis
• Edição colaborativa em tempo real
• Suporte a hieróglifos e caracteres complexos
• Suporte nativo para 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 Enterprise Edition.

Ao utilizá-lo no ecossistema do ONLYOFFICE Workspace, você também poderá:

• Compartilhar arquivos internamente e externamente;
• Gerenciar permissões e direitos de acesso restrito a documentos;
• Incorporar documentos em sites e portais;
• Visualizar e editar arquivos armazenados em provedores como Google Drive, Box, Dropbox, OneDrive e OwnCloud conectados ao ONLYOFFICE.

Este guia demonstrará como instalar a versão Linux do ONLYOFFICE Docs Enterprise Edition utilizando a engine do Podman no Fedora. O Podman é uma ferramenta nativa sem daemon (daemonless) projetada para executar, gerenciar e orquestrar contêineres Linux de forma altamente segura.

Requisitos de sistema

• CPU: Processador Dual Core de 2 GHz ou superior (arquitetura ARM de 64 bits)
• RAM: 4 GB ou mais
• HDD / SSD: Pelo menos 40 GB de espaço livre em disco
• SWAP: Pelo menos 4 GB (A eficiência do Swap depende estritamente do sistema operacional host)
• Sistema Operacional: Distribuição Linux amd64 ou arm64 com versão de kernel 3.10 ou posterior (Recomendado Fedora)

Instalando o ONLYOFFICE Docs

Executando o ONLYOFFICE Docs com Podman como usuário root

Primeiro, crie as pastas físicas no host para armazenar e persistir os logs, bancos de dados e volumes de configuração do contêiner:

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 a imagem do 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-ee:latest

Para verificar se o contêiner do ONLYOFFICE Docs subiu e está funcionando corretamente, execute o gatilho de teste integrado:

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

Em seguida, abra o seu navegador de internet, acesse http://localhost/welcome e clique no botão GO TO TEST EXAMPLE. Você será direcionado para uma interface de testes onde poderá criar documentos com conteúdos de exemplo para validar a edição.

Mudando o ONLYOFFICE Docs para HTTPS

Para garantir a segurança do tráfego, instale os certificados SSL privados (onlyoffice.key e onlyoffice.crt) em seu servidor físico e injete-os reiniciando o contêiner do ONLYOFFICE Docs usando os comandos abaixo:

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}

Construindo a imagem a partir do repositório (Podman Build)

Se você precisar construir a imagem in-house, clone o repositório público do ONLYOFFICE Docs, acesse a pasta e construa a imagem localmente como superusuário:

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

Construindo a imagem com o utilitário Buildah

Alternativamente, você pode usar o utilitário standalone Buildah. Execute o seguinte comando:

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

Executando o contêiner gerado pelo Buildah

Após construir com sucesso a imagem customizada com o Buildah, execute a instância do ONLYOFFICE Docs apontando para o seu repositório taggado em `localhost`:

sudo 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 sua versão Enterprise Edition

Se você adquiriu a licença corporativa Enterprise Edition e obteve o arquivo assinado license.lic, você deve repassá-lo ao contêiner para destravar as restrições.

Ao trabalhar com instâncias gerenciadas pelo Podman, o arquivo license.lic pode ser alocado na pasta de mapeamento de dados recém-criada (por exemplo: /app/onlyoffice/DocumentServer/data/license.lic). Você precisará assegurar que a montagem de volume seja declarada na inicialização do contêiner:

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

No momento do carregamento, a engine reconhecerá o arquivo injetado no volume, e a sua instalação do Enterprise Edition será convertida para a versão registrada e completa automaticamente.