Home
Compilar o Document Builder a partir do código-fonte

Compilar o Document Builder a partir do código-fonte

Introdução

O Document Builder é uma ferramenta avançada projetada para gerar arquivos de texto, planilhas, apresentações e PDFs de forma dinâmica, automatizando a construção de documentos a partir de modelos. Ele pode ser perfeitamente integrado ao seu sistema de gerenciamento de documentos (DMS) utilizando a sua API JavaScript nativa.

Você pode compilar o Document Builder diretamente a partir dos repositórios de código-fonte e implantá-lo em seu servidor local utilizando o kit de utilitários build_tools. Esses scripts automatizam o download e a instalação de todos os componentes necessários, resolvem as dependências do sistema host e compilam a versão mais recente dos binários do construtor de documentos.

Garantia de Compilação: A engenharia do ONLYOFFICE garante o funcionamento correto apenas para os binários compilados a partir da branch mestre (master) dos repositórios oficiais.

Requisitos de Sistema da Instância

Hardware Recomendado:

CPU: Processador Dual-Core de 2 GHz ou superior.
Memória RAM: Mínimo de 2 GB (a alocação real varia segundo a carga do SO host; quanto mais recursos disponíveis, melhor a performance).
Armazenamento (HDD/SSD): Pelo menos 40 GB de espaço livre em disco.
Partição SWAP: Mínimo de 4 GB configurados no sistema.

Software Homologado:

Sistema Operacional: Ubuntu 16.04 LTS de 64-bits.

Nota de Infraestrutura: Este ambiente foi exaustivamente testado sobre o Ubuntu 16.04. A adoção de outras distribuições Linux pode exigir a instalação manual de pacotes e dependências não detalhadas neste manual.

1. Instalando as dependências base

Antes de iniciar a compilação, certifique-se de que o interpretador Python e o gerenciador de versão Git estão presentes em seu ambiente local. Você pode instalá-los executando o seguinte comando no terminal:

sudo apt-get install -y python git

2. Compilando o código-fonte do Document Builder

Siga os passos abaixo para baixar, processar e compilar o código bruto da aplicação:

Clone o repositório mestre das ferramentas de automação:
```
git clone https://github.com/ONLYOFFICE/build_tools.git
```
Navegue até o diretório interno que contém as receitas de build para Linux:
```
cd build_tools/tools/linux
```
Invoque o script orquestrador automate.py passando o parâmetro de flag builder para isolar a compilação exclusivamente no pacote do Document Builder:
```
./automate.py builder
```
Compilação Completa (Opcional): Caso o script seja executado sem parâmetros adicionais, o sistema processará a compilação conjunta do Document Builder, do ONLYOFFICE Docs e dos Desktop Editors de uma só vez:
```
./automate.py
```
Para aprofundar o entendimento sobre a compilação modular das demais soluções do ecossistema, consulte os manuais específicos de compilação do ONLYOFFICE Docs e dos Desktop Editors.

Nota de processamento: Aguarde a finalização da execução do script Python. Este ciclo consome bastante processamento computacional; em um processador equivalente a um Intel Core i7-7700, o build completo pode levar aproximadamente 3 horas para finalizar.

O interpretador se encarregará de compilar todas as dependências isoladas que integram o núcleo de funcionalidades do Document Builder.

Assim que o retorno terminal indicar o fim do processo, os arquivos binários compilados estarão disponíveis no diretório de saída: ../../out/linux_64/onlyoffice/documentbuilder/. Você já pode inicializar o serviço em seu servidor.

3. Executando o Document Builder

Navegue até o diretório onde os binários de saída foram alocados:

cd ../../out/linux_64/onlyoffice/documentbuilder

Inicialize o daemon executando o binário base na sua interface de terminal:

./docbuilder