Comment installer Odoo 15 sur Ubuntu 20.04

Odoo est une suite d'applications professionnelles open source populaire qui aide les entreprises à gérer et à gérer leur entreprise. Il comprend une large gamme d'applications telles que le CRM, le commerce électronique, la création de sites Web, la facturation, la comptabilité, la fabrication, l'entrepôt, la gestion de projet, l'inventaire et bien plus encore, toutes intégrées de manière transparente.

Odoo peut être installé de différentes manières, selon le cas d'utilisation et les technologies disponibles. Le moyen le plus simple et le plus rapide d'installer Odoo consiste à utiliser les référentiels APT officiels d'Odoo.

L'installation d'Odoo dans un environnement virtuel, ou le déploiement en tant que Dockercontainer, vous donne plus de contrôle sur l'application et vous permet d'exécuter plusieurs instances d'Odoo sur le même système.

Cet article décrit l'installation et le déploiement d'Odoo 15 dans un environnement virtuel Python sur Ubuntu 20.04. Nous allons télécharger Odoo depuis le référentiel officiel GitHub et utiliser Nginx comme proxy inverse.

Installation des dépendances #

La première étape consiste à installer Git, Pip, Node.js et le développement [outils nécessaires à la construction] (https://linuxize.com/post/how-to-install-gcc-on-ubuntu-20-04/ Odoo dépendances :

sudo apt updatesudo apt install git python3-pip build-essential wget python3-dev python3-venv \    python3-wheel libfreetype6-dev libxml2-dev libzip-dev libldap2-dev libsasl2-dev \    python3-setuptools node-less libjpeg-dev zlib1g-dev libpq-dev \    libxslt1-dev libldap2-dev libtiff5-dev libjpeg8-dev libopenjp2-7-dev \    liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev

Création d'un numéro d'utilisateur système

Exécuter Odoo sous l'utilisateur root pose un grand risque de sécurité. Nous allons créer un nouvel utilisateur système et un groupe avec le répertoire personnel /opt/odoo15 qui exécutera le service Odoo. Pour ce faire, exécutez la commande suivante :

sudo useradd -m -d /opt/odoo15 -U -r -s /bin/bash odoo15

Vous pouvez nommer l'utilisateur comme vous le souhaitez, tant que vous créez un utilisateur PostgreSQL avec le même nom.

Installation et configuration de PostgreSQL #

Odoo utilise PostgreSQL comme back-end de la base de données. PostgreSQL est inclus dans les référentiels Ubuntu standard. L'installation est simple :

sudo apt install postgresql

Une fois le service installé, créez un utilisateur PostgreSQL avec le même nom que l'utilisateur système créé précédemment. Dans cet exemple, c'est odoo15 :

sudo su - postgres -c "createuser -s odoo15"

Installation de wkhtmltopdf #

wkhtmltopdf est un ensemble d'outils de ligne de commande open source pour le rendu des pages HTML en PDF et divers formats d'image. Pour imprimer des rapports PDF dans Odoo, vous devrez installer le wkhtmltox paquet.

La version de wkhtmltopdf incluse dans les référentiels Ubuntu ne prend pas en charge les en-têtes et les pieds de page. La version recommandée pour Odoo est la version 0.12.5 . Nous allons télécharger et installer le package depuis Github :

sudo wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb

Une fois le fichier téléchargé, installez-le en tapant :

sudo apt install ./wkhtmltox_0.12.5-1.bionic_amd64.deb

Installer et configurer Odoo 15 #

Nous installerons Odoo à partir de la source dans un environnement virtuel Python isolé.

Tout d'abord, passez à l'utilisateur "odoo15":

sudo su - odoo15

Clonez le code source d'Odoo 15 depuis GitHub :

git clone https://www.github.com/odoo/odoo --depth 1 --branch 15.0 /opt/odoo15/odoo

Créez un nouvel environnement virtuel Python pour Odoo :

cd /opt/odoo15python3 -m venv odoo-venv

Activez l'environnement virtuel :

source odoo-venv/bin/activate

Les dépendances Odoo sont spécifiées dans le fichier requirements.txt. Installez tous les modules Python requis avec pip3 :

pip3 install wheelpip3 install -r odoo/requirements.txt

Si vous rencontrez une erreur de compilation lors de l'installation, assurez-vous que toutes les dépendances requises sont répertoriées dans le Installing Prerequisites section sont installés.

Une fois cela fait, désactivez l'environnement en tapant :

deactivate

Nous allons créer un nouveau répertoire, un répertoire séparé pour les addons tiers :

mkdir /opt/odoo15/odoo-custom-addons

Plus tard, nous ajouterons ce répertoire au addons_path paramètre. Ce paramètre définit une liste de répertoires où Odoo recherche les modules.

Revenez à votre utilisateur sudo :

exit

Créez un fichier de configuration avec le contenu suivant :

sudo nano /etc/odoo15.conf

/etc/odoo15.conf

[options]
; This is the password that allows database operations:
admin_passwd = my_admin_passwd
db_host = False
db_port = False
db_user = odoo15
db_password = False
addons_path = /opt/odoo15/odoo/addons,/opt/odoo15/odoo-custom-addons

N'oubliez pas de modifier le my_admin_passwd à quelque chose de plus sûr.

Création du fichier d'unité Systemd #

Un fichier d'unité est un fichier de configuration de style ini qui contient des informations sur un service.

Ouvrez votre éditeur de texte et créez un fichier nommé odoo15.service avec le contenu suivant :

sudo nano /etc/systemd/system/odoo15.service

/etc/systemd/system/odoo15.service

[Unit]
Description=Odoo15
Requires=postgresql.service
After=network.target postgresql.service

[Service]
Type=simple
SyslogIdentifier=odoo15
PermissionsStartOnly=true
User=odoo15
Group=odoo15
ExecStart=/opt/odoo15/odoo-venv/bin/python3 /opt/odoo15/odoo/odoo-bin -c /etc/odoo15.conf
StandardOutput=journal+console

[Install]
WantedBy=multi-user.target

Avertir systemd qu'un nouveau fichier d'unité existe :

sudo systemctl daemon-reload

Démarrez le service Odoo et activez-le au démarrage en exécutant :

sudo systemctl enable --now odoo15

Vérifiez que le service est opérationnel :

sudo systemctl status odoo15

La sortie devrait ressembler à quelque chose comme ci-dessous, montrant que le service Odoo est actif et en cours d'exécution :

● odoo15.service - Odoo15
     Loaded: loaded (/etc/systemd/system/odoo15.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2021-10-26 09:56:28 UTC; 28s ago
...

Vous pouvez vérifier les messages enregistrés par le service Odoo en utilisant la commande ci-dessous :

sudo journalctl -u odoo15

Test de l'installation #

Ouvrez votre navigateur et tapez :http://<your_domain_or_IP_address>:8069

En supposant que l'installation est réussie, un écran semblable au suivant apparaît :

Configuration de Nginx en tant que proxy de terminaison SSL #

Le serveur Web Odoo par défaut dessert le trafic via HTTP. Pour rendre le déploiement d'Odoo plus sécurisé, nous allons définir Nginx comme proxy de terminaison SSL qui servira le trafic via HTTPS.

Le proxy de terminaison SSL est un serveur proxy qui gère le cryptage/décryptage SSL. Cela signifie que le proxy de terminaison (Nginx) traitera et déchiffrera les connexions TLS entrantes (HTTPS) et transmettra les requêtes non chiffrées au service interne (Odoo). Le trafic entre Nginx et Odoo ne sera pas crypté (HTTP).

L'utilisation d'un proxy inverse vous offre de nombreux avantages tels que l'équilibrage de charge, la terminaison SSL, la mise en cache, la compression, la diffusion de contenu statique, etc.

Assurez-vous que vous avez satisfait aux prérequis suivants avant de continuer avec cette section :

Nom de domaine pointant vers l'adresse IP de votre serveur public. Nous utiliserons example.com .
Nginx installé.
Certificat SSL pour votre domaine. Vous pouvez installer un certificat SSL Let's Encrypt gratuit.

Ouvrez votre éditeur de texte et créez/modifiez le bloc du serveur de domaine :

sudo nano /etc/nginx/sites-enabled/example.com.conf

La configuration suivante configure la terminaison SSL, la redirection HTTP vers HTTPS, la redirection WWW vers non-WWW, met en cache les fichiers statiques et active la compression GZip.

/etc/nginx/sites-enabled/example.com.conf

# Odoo servers
upstream odoo {
 server 127.0.0.1:8069;
}

upstream odoochat {
 server 127.0.0.1:8072;
}

# HTTP -> HTTPS
server {
    listen 80;
    server_name www.example.com example.com;

    include snippets/letsencrypt.conf;
    return 301 https://example.com$request_uri;
}

# WWW -> NON WWW
server {
    listen 443 ssl http2;
    server_name www.example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
    include snippets/ssl.conf;
    include snippets/letsencrypt.conf;

    return 301 https://example.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com;

    proxy_read_timeout 720s;
    proxy_connect_timeout 720s;
    proxy_send_timeout 720s;

    # Proxy headers
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;

    # SSL parameters
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
    include snippets/ssl.conf;
    include snippets/letsencrypt.conf;

    # log files
    access_log /var/log/nginx/odoo.access.log;
    error_log /var/log/nginx/odoo.error.log;

    # Handle longpoll requests
    location /longpolling {
        proxy_pass http://odoochat;
    }

    # Handle / requests
    location / {
       proxy_redirect off;
       proxy_pass http://odoo;
    }

    # Cache static files
    location ~* /web/static/ {
        proxy_cache_valid 200 90m;
        proxy_buffering on;
        expires 864000;
        proxy_pass http://odoo;
    }

    # Gzip
    gzip_types text/css text/less text/plain text/xml application/xml application/json application/javascript;
    gzip on;
}

N'oubliez pas de remplacer example.com par votre domaine Odoo et de définir le chemin correct vers les fichiers de certificat SSL. Les extraits utilisés dans cette configuration sont créés dans ce guide.

Une fois que vous avez terminé, redémarrez le service Nginx :

sudo systemctl restart nginx

Ensuite, nous devons dire à Odoo d'utiliser le proxy. Pour cela, ouvrez le fichier de configuration et ajoutez la ligne suivante :

/etc/odoo15.conf

proxy_mode = True

Redémarrez le service Odoo pour que les modifications prennent effet :

sudo systemctl restart odoo15

À ce stade, le proxy inverse est configuré et vous pouvez accéder à votre instance Odoo sur https://example.com .

Modification de l'interface de liaison #

Cette étape est facultative, mais c'est une bonne pratique de sécurité.

Par défaut, le serveur Odoo écoute le port 8069 sur toutes les interfaces. Pour désactiver l'accès direct à l'instance Odoo, vous pouvez soit bloquer le port 8069 pour toutes les interfaces publiques ou forcer Odoo à n'écouter que sur l'interface locale.

Nous allons configurer Odoo pour écouter uniquement sur 127.0.0.1 . Ouvrez la configuration ajoutez les deux lignes suivantes à la fin du fichier :

/etc/odoo15.conf

xmlrpc_interface = 127.0.0.1
netrpc_interface = 127.0.0.1

Enregistrez le fichier de configuration et redémarrez le serveur Odoo pour que les modifications prennent effet :

sudo systemctl restart odoo15

Activation du multitraitement #

Par défaut, Odoo fonctionne en mode multithreading. Pour les déploiements de production, il est recommandé de passer au serveur multitraitement car il augmente la stabilité et permet une meilleure utilisation des ressources système.

Pour activer le multitraitement, vous devez modifier la configuration d'Odoo et définir un nombre non nul de processus de travail. Le nombre de travailleurs est calculé en fonction du nombre de cœurs de processeur dans le système et de la mémoire RAM disponible.

Selon la documentation officielle d'Odoo, pour calculer le nombre de travailleurs et la taille de mémoire RAM requise, vous pouvez utiliser les formules et hypothèses suivantes :

Calcul du nombre de travailleurs

Nombre maximal théorique de worker =(system_cpus * 2) + 1
1 travailleur peut servir ~=6 utilisateurs simultanés
Les nœuds de calcul Cron nécessitent également un processeur

Calcul de la taille de la mémoire RAM

Nous considérerons que 20 % de toutes les demandes sont des demandes lourdes et 80 % sont des demandes plus légères. Les requêtes lourdes utilisent environ 1 Go de RAM tandis que les plus légères utilisent environ 150 Mo de RAM
RAM nécessaire =number_of_workers * ( (light_worker_ratio * light_worker_ram_estimation) + (heavy_worker_ratio * heavy_worker_ram_estimation) )

Si vous ne savez pas combien de processeurs vous avez sur votre système, utilisez le grep suivant commande :

grep -c ^processor /proc/cpuinfo

Disons que vous avez un système avec 4 cœurs de processeur, 8 Go de mémoire RAM et 30 utilisateurs Odoo simultanés.

30 users / 6 = **5** (5 est le nombre théorique de travailleurs nécessaires)
(4 * 2) + 1 = **9** (9 est le nombre maximum théorique de travailleurs)

Sur la base du calcul ci-dessus, vous pouvez utiliser 5 travailleurs + 1 travailleur pour le travailleur cron, soit un total de 6 travailleurs.

Calculez la consommation de mémoire RAM en fonction du nombre de travailleurs :

RAM = 6 * ((0.8*150) + (0.2*1024)) ~= 2 GB of RAM

Le calcul montre que l'installation d'Odoo aura besoin d'environ 2 Go de RAM.

Pour passer en mode multitraitement, ouvrez le fichier de configuration et ajoutez les valeurs calculées :

/etc/odoo15.conf

limit_memory_hard = 2684354560
limit_memory_soft = 2147483648
limit_request = 8192
limit_time_cpu = 600
limit_time_real = 1200
max_cron_threads = 1
workers = 5

Redémarrez le service Odoo pour que les modifications prennent effet :

sudo systemctl restart odoo15

Le reste des ressources système sera utilisé par d'autres services qui s'exécutent sur ce système. Dans ce guide, nous avons installé Odoo avec PostgreSQL et Nginx sur le même serveur. Selon votre configuration, d'autres services peuvent également être exécutés sur votre serveur.