Instalando o ONLYOFFICE Docs Developer Edition via script

Introdução

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

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

Principais Funcionalidades:

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

A versão Developer Edition do ONLYOFFICE Docs pode ser provisionada rapidamente usando um script de instalação automática para sistemas operacionais Linux com o Docker instalado. O script configurará toda a arquitetura de rede e os contêineres Docker com os microsserviços necessários para o funcionamento isolado do software, tornando-o fácil de executar, gerenciar e atualizar.

Este guia demonstrará como instalar o ONLYOFFICE Docs Developer Edition em sua máquina usando o script orquestrador fornecido. Alternativamente, você também verá como utilizar parâmetros extras do script para escolher uma instalação tradicional a partir de pacotes RPM/DEB diretos do sistema.

Requisitos de sistema

• CPU: Processador Dual core de 2 GHz ou superior
• RAM: Mínimo de 4 GB
• HDD / SSD: Pelo menos 40 GB de espaço livre em disco
• SWAP: Pelo menos 4 GB (A eficiência do Swap depende diretamente da configuração do SO host)
• SO: Distribuição Linux amd64 com versão de kernel 3.10 ou posterior

Obtendo o script do ONLYOFFICE Docs

Para iniciar, baixe o arquivo de script de automação oficial do ONLYOFFICE Docs Developer Edition em seu servidor utilizando o comando abaixo:

curl -O http://download.onlyoffice.com/docs/docs-developer-install.sh

Assim que o download for concluído e o arquivo `.sh` estiver presente no diretório, você poderá iniciar o processo de instalação.

Instalando o ONLYOFFICE Docs (Via Docker)

Para executar o script de instalação do ONLYOFFICE Docs Developer Edition, digite o seguinte comando:

bash docs-developer-install.sh

O terminal solicitará interativamente que você selecione o modelo de instalação desejado. Digite Y e pressione Enter para confirmar a instalação automatizada conteinerizada utilizando o Docker.

Instalando o ONLYOFFICE Docs com parâmetros de script avançados

Você pode precisar executar o script especificando parâmetros de inicialização adicionais – por exemplo, para forçar o serviço a rodar em uma porta específica de rede ou puxar uma versão legada exata.

Para exibir o menu de ajuda com a lista de todos os parâmetros de script disponíveis, use a flag -h:

bash docs-developer-install.sh -h

Abaixo, listamos alguns dos exemplos mais comuns de sintaxe utilizando parâmetros de script:

• Para instalar o ONLYOFFICE Docs instruindo os contêineres a operarem em uma determinada porta web, utilize o parâmetro -dp. Por padrão estrito, a porta 80 é usada. Exemplo usando a porta alternativa 8080:

  bash docs-developer-install.sh -dp 8080

• Para forçar a instalação do ONLYOFFICE Docs utilizando uma imagem Docker originária de um repositório específico no hub, use o parâmetro -di:

  bash docs-developer-install.sh -di onlyoffice/documentserver-de

• Para instalar uma determinada versão congelada (release) do ONLYOFFICE Docs, use o parâmetro -dv. Se este parâmetro for omitido da linha de comando, a tag "latest" (versão mais recente disponível) será baixada.
  A flag de congelamento de versão (-dv) só funcionará caso você prossiga com a instalação conteinerizada (via Docker). Caso opte pelo processo nativo com pacotes DEB/RPM, os gerenciadores do sistema sempre puxarão o pacote majoritário mais atual.

  bash docs-developer-install.sh -dv 6.2.2

• Para atualizar uma instância já existente do ONLYOFFICE Docs na sua máquina através do script, utilize a flag de atualização -u configurada com o operador booleano true:

  bash docs-developer-install.sh -u true

Instalando o ONLYOFFICE Docs a partir de pacotes nativos (DEB/RPM)

Se você preferir dispensar os contêineres e instalar o Developer Edition diretamente na camada do sistema host:

bash docs-developer-install.sh

Quando o instalador solicitar a forma de configuração preferida no terminal, digite N (Não usar Docker) e pressione Enter. O script acionará os gerenciadores de pacotes correspondentes do seu Linux (APT ou YUM/DNF) para construir e instalar as dependências e arquivos DEB ou RPM do ONLYOFFICE.

Instalando o ONLYOFFICE Docs como parte integrada do ONLYOFFICE Workspace

A arquitetura do ONLYOFFICE Docs atua como o motor de edição do ecossistema principal do ONLYOFFICE Workspace (que compreende também o ONLYOFFICE Community Server, o Control Panel e o Mail Server). Caso o seu objetivo seja montar o ecossistema corporativo completo de uma vez só usando os scripts automatizados, leia e siga rigorosamente estas instruções de instalação do Workspace.

Registrando a sua chave de licença Developer Edition

Se você assinou um plano e recebeu a sua chave criptográfica license.lic, você deverá injetá-la no ambiente para remover as limitações operacionais da versão de desenvolvimento.

• Se você instalou utilizando o script do Docker: A pasta raiz do volume é mapeada no sistema de arquivos do seu host automaticamente. Copie o arquivo license.lic diretamente para o diretório físico /app/onlyoffice/DocumentServer/data/.
• Se você instalou a partir do processo de pacotes DEB/RPM: A aplicação já está rodando em nível de sistema. Aloque e mova o arquivo license.lic estritamente para a pasta /var/www/onlyoffice/Data/.

Após a alocação e leitura das permissões pela instância, a sua distribuição local do Developer Edition estará registrada e operando de forma completa.