Compiler le Générateur de documents

Introduction

Le Générateur de documents est un outil qui permet de générer des documents texte, des classeurs, des présentations et des fichiers PDF, et d'automatiser la création de documents à partir de modèles. Il s'intègre facilement à votre système de gestion documentaire grâce à son API JavaScript.

Vous pouvez compiler facilement le Générateur de documents à partir du code source et déployer la solution sur votre serveur local à l'aide des build_tools conçus à cette fin. Les build_tools permettent de récupérer et d'installer automatiquement tous les composants nécessaires au processus de compilation ainsi que toutes les dépendances requises pour le bon fonctionnement du Générateur de documents, mais aussi d'obtenir la dernière version du code source du Générateur de documents et de compiler l'ensemble de ses composants.

Important Nous ne pouvons garantir le bon fonctionnement que des produits compilés à partir de la branche master.

Configuration système minimale

Matériel

CPU : 4 cœurs
RAM : au moins 8 Go. Plus il y en a, mieux c'est
HDD : au moins 100 Go de SSD
SWAP : au moins 4 Go, mais cela dépend du système d'exploitation hôte. Plus il y en a, mieux c'est

Logiciels

Système d'exploitation : Ubuntu 24.04

La solution a été testée sur Ubuntu 24.04. D'autres distributions peuvent nécessiter des manipulations spécifiques qui ne sont pas décrites ici.

Installer les dépendances

Il peut être nécessaire d'installer Python et Git s'ils ne sont pas encore présents sur votre ordinateur. Pour ce faire, utilisez la commande suivante :

sudo apt-get install -y python3 git

Construire le Générateur de documents à partir du code source

Clonez le dépôt build_tools :

git clone https://github.com/ONLYOFFICE/build_tools.git

Accédez au répertoire build_tools/tools/linux :
```
cd build_tools/tools/linux
```
Exécutez le script automate.py en indiquant le paramètre builder pour compiler le Générateur de documents :
```
python3 ./automate.py builder
```
Si vous exécutez le script sans aucun paramètre, il compile à la fois le Générateur de documents, ONLYOFFICE Docs et les éditeurs de bureau.
```
python3 ./automate.py
```
Le cas échéant, vous pouvez compiler plusieurs produits à la fois en exécutant le script avec les paramètres correspondant aux produits souhaités. Pour en savoir plus sur la compilation d'ONLYOFFICE Docs, consultez cet article. Pour en savoir plus sur la compilation des éditeurs de bureau, consultez cet article.

Attendez la fin de l'exécution du script. Selon les capacités de votre ordinateur, cette opération peut prendre un temps considérable : comptez au moins 3 heures avec 4x2.3GHz vCPUs.

Le script compile toutes les dépendances et tous les composants qui font partie du Générateur de documents.

La version compilée est disponible dans le répertoire ../../out/linux_64/onlyoffice/documentbuilder/. Vous pouvez maintenant procéder au lancement du Générateur de documents sur votre serveur.

Exécuter le Générateur de documents

Accédez au répertoire ../../out/linux_64/onlyoffice/documentbuilder/ :

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

Exécutez la commande suivante :

./docbuilder