Comment déployer Odoo 11 sur Ubuntu 18.04

Odoo est le logiciel d’entreprise tout-en-un le plus populaire au monde. Il offre une gamme d’applications commerciales, notamment CRM, site Web, commerce électronique, facturation, comptabilité, fabrication, entrepôt, gestion de projet, inventaire et bien plus encore, le tout parfaitement intégré.

Il existe plusieurs façons d’installer Odoo en fonction du cas d’utilisation requis. La façon la plus simple et la plus rapide d’installer Odoo est d’utiliser leurs dépôts officiels APT.

Si vous souhaitez avoir plus de flexibilité, comme exécuter plusieurs versions d’Odoo sur un même système, vous pouvez soit utiliser docker et docker composer, soit installer Odoo dans un environnement virtuel.

Ce guide couvre les étapes nécessaires à l’installation et à la configuration d’Odoo pour la production à l’aide de la source Git et de l’environnement virtuel Python sur un système Ubuntu 18.04.

Avant que tu commences #

Connectez-vous à votre machine Ubuntu en tant qu’utilisateur sudo et mettez à jour le système vers les derniers packages:

sudo apt update && sudo apt upgrade

Installez Git, Pip, Node.js et les outils nécessaires pour créer des dépendances Odoo:

sudo apt install git python3-pip build-essential wget python3-dev python3-venv python3-wheel libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools node-less

Créer un utilisateur Odoo #

Créer un nouvel utilisateur système et un groupe avec le répertoire personnel/opt/odooqui exécutera le service Odoo.

sudo useradd -m -d /opt/odoo -U -r -s /bin/bash odoo
Vous pouvez nommer l’utilisateur comme bon vous semble, assurez-vous simplement de créer un utilisateur postgres avec le même nom.

Installez et configurez PostgreSQL #

Installez le package PostgreSQL à partir des référentiels par défaut d’Ubuntu:

sudo apt install postgresql

Une fois l’installation terminée, créez un utilisateur PostgreSQL avec le même nom que l’utilisateur système précédemment créé, dans notre casodoo:

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

Installez Wkhtmltopdf #

lewkhtmltoxpackage fournit un ensemble d’outils de ligne de commande open-source qui peuvent rendre HTML en PDF et divers formats d’image. Pour imprimer des rapports PDF, vous aurez besoin duwkhtmltopdfoutil. La version recommandée pour Odoo est0.12.1qui n’est pas disponible dans les dépôts officiels d’Ubuntu 18.04.

Téléchargez le package à l’aide de la commande wget suivante:

wget https://builds.wkhtmltopdf.org/0.12.1.3/wkhtmltox_0.12.1.3-1~bionic_amd64.deb

Une fois le téléchargement terminé, installez le package en tapant:

sudo apt install ./wkhtmltox_0.12.1.3-1~bionic_amd64.deb

Installer et configurer Odoo #

Nous allons installer Odoo à partir du référentiel GitHub dans un environnement virtuel Python isolé afin que nous puissions avoir plus de contrôle sur les versions et les mises à jour.

Avant de commencer le processus d’installation, assurez-vous de passer àodooutilisateur.

sudo su - odoo

Pour confirmer que vous êtes connecté en tant queodooutilisateur, vous pouvez utiliser la commande suivante:

whoami

Nous pouvons maintenant commencer par le processus d’installation. Commencez par cloner l’odoo du référentiel GitHub:

git clone https://www.github.com/odoo/odoo --depth 1 --branch 11.0 /opt/odoo/odoo11
  • Si vous souhaitez installer une autre version d’Odoo, changez simplement le numéro de version après--branchcommutateur.
  • Vous pouvez nommer le répertoire comme vous le souhaitez, par exemple à la placeodoo11vous pouvez utiliser le nom de votre domaine.

Pour créer un nouvel environnement virtuel pour l’exécution de l’instance Odoo 11:

cd /opt/odoopython3 -m venv odoo11-venv

activez l’environnement avec la commande suivante:

source odoo11-venv/bin/activate

et installez tous les modules Python requis avec pip3:

pip3 install wheelpip3 install -r odoo11/requirements.txt

pip3est un outil pour installer et gérer les packages Python.

Si vous rencontrez des erreurs de compilation lors de l’installation, assurez-vous d’avoir installé toutes les dépendances requises répertoriées dans leBefore you beginsection.

Une fois l’installation terminée, désactivez l’environnement et revenez à votre utilisateur sudo à l’aide des commandes suivantes:

deactivate
exit

Si vous prévoyez d’installer des modules personnalisés, il est préférable d’installer ces modules dans un répertoire distinct. Pour créer un nouveau répertoire pour nos modules personnalisés, exécutez:

sudo mkdir /opt/odoo/odoo11-custom-addonssudo chown odoo: /opt/odoo/odoo11-custom-addons

Ensuite, nous devons créer un fichier de configuration, nous pouvons soit en créer un nouveau à partir de zéro, soit copier le fichier de configuration inclus:

sudo cp /opt/odoo/odoo11/debian/odoo.conf /etc/odoo11.conf

Ouvrez le fichier et modifiez-le comme suit:

/etc/odoo11.conf
[options]
; This is the password that allows database operations:
admin_passwd = my_admin_passwd
db_host = False
db_port = False
db_user = odoo
db_password = False
addons_path = /opt/odoo/odoo11/addons
; If you are using custom modules
; addons_path = /opt/odoo/odoo11/addons,/opt/odoo/odoo11-custom-addons
N’oubliez pas de changer lemy_admin_passwdà quelque chose de plus sûr et d’ajuster laaddons_pathsi vous utilisez des modules personnalisés.

Créer un fichier d’unité systemd #

Pour exécuter odoo en tant que service, nous allons créer unodoo11.servicefichier d’unité dans le/etc/systemd/system/répertoire avec le contenu suivant:

/etc/systemd/system/odoo11.service
[Unit]
Description=Odoo11
Requires=postgresql.service
After=network.target postgresql.service

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

[Install]
WantedBy=multi-user.target

Informez systemd que nous avons créé un nouveau fichier d’unité et démarrez le service Odoo en exécutant:

sudo systemctl daemon-reloadsudo systemctl start odoo11

Vous pouvez vérifier l’état du service avec la commande suivante:

sudo systemctl status odoo11
● odoo11.service - Odoo11
   Loaded: loaded (/etc/systemd/system/odoo11.service; disabled; vendor preset: enabled)
   Active: active (running) since Thu 2018-05-03 21:23:08 UTC; 3s ago
 Main PID: 18351 (python3)
    Tasks: 4 (limit: 507)
   CGroup: /system.slice/odoo11.service
           └─18351 /opt/odoo/odoo11-venv/bin/python3 /opt/odoo/odoo11/odoo-bin -c /etc/odoo11.conf

et s’il n’y a pas d’erreur, vous pouvez activer le démarrage automatique du service Odoo au démarrage:

sudo systemctl enable odoo11

Si vous souhaitez voir les messages enregistrés par le service Odoo, vous pouvez utiliser la commande ci-dessous:

sudo journalctl -u odoo11

Testez l’installation #

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

En supposant que l’installation est réussie, un écran similaire au suivant apparaîtra:

Configurer Nginx comme proxy de terminaison SSL #

Si vous souhaitez utiliser Nginx comme proxy de terminaison SSL, assurez-vous que vous avez satisfait aux conditions préalables suivantes:

  • Vous avez un nom de domaine pointant vers l’IP de votre serveur public. Dans ce tutoriel, nous utiliseronsexample.com.
  • Vous avez installé Nginx en suivant ces instructions.
  • Vous avez un certificat SSL installé pour votre domaine. Vous pouvez installer un certificat SSL Let’s Encrypt gratuit en suivant ces instructions.

Le serveur Web Odoo par défaut sert le trafic via HTTP. Pour rendre notre déploiement Odoo plus sécurisé, nous allons configurer Nginx comme un 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 notre proxy de terminaison (Nginx) gérera et déchiffrera les connexions TLS entrantes (HTTPS) et transmettra les demandes non chiffrées à notre service interne (Odoo) afin que le trafic entre Nginx et Odoo ne soit pas chiffré (HTTP).

Nous devons dire à Odoo que nous allons utiliser un proxy, ouvrir le fichier de configuration et ajouter la ligne suivante:

/etc/odoo11.conf
proxy_mode = True

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

sudo systemctl restart odoo11

L’utilisation de Nginx comme proxy nous offre plusieurs avantages. Dans cet exemple, nous allons configurer la terminaison SSL, la redirection HTTP vers HTTPS, la redirection WWW vers non WWW, mettre en cache les fichiers statiques et activer la compression GZip.

/etc/nginx/sites-enabled/example.com
# 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 d’accès correct aux fichiers de certificat SSL. Les extraits de code utilisés dans cette configuration sont créés dans ce guide.

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

sudo systemctl restart nginx

Changer 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, donc si vous souhaitez désactiver l’accès direct à votre instance Odoo, vous pouvez soit bloquer le port 8069 pour toutes les interfaces publiques ou forcer Odoo à écouter uniquement sur l’interface locale.

Dans ce guide, nous forcerons Odoo à écouter uniquement sur127.0.0.1, ouvrez la configuration Odoo ajoutez les deux lignes suivantes à la fin du fichier:

/etc/odoo11.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 odoo

Activer le multitraitement #

Par défaut, Odoo fonctionne en mode multithreading. Pour les déploiements en production, il est recommandé de basculer vers le serveur multiprocesseur car il augmente la stabilité et optimise l’utilisation des ressources système. Afin d’activer le multitraitement, nous devons modifier la configuration 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, nous utiliserons les formules et hypothèses suivantes:

Calcul du nombre de travailleurs

  • nombre maximum théorique de travailleurs = (cpus système * 2) + 1
  • 1 travailleur peut servir ~ = 6 utilisateurs simultanés
  • Les travailleurs 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, tandis que 80% sont plus légères. Les demandes lourdes utilisent environ 1 Go de RAM tandis que les plus légères utilisent environ 150 Mo de RAM
  • RAM nécessaire = nombre_de_travailleurs * ((light_worker_ratio * light_worker_ram_estimation) + (heavy_worker_ratio * heavy_worker_ram_estimation))

Si vous ne savez pas combien de CPU vous avez sur votre système, vous pouvez utiliser la commande suivante:

grep -c ^processor /proc/cpuinfo

Disons que nous avons 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, nous pouvons utiliser 5 travailleurs + 1 travailleur pour le travailleur cron qui est 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 ci-dessus nous montre que notre installation Odoo aura besoin d’environ 2 Go de RAM.

Pour passer en mode multitraitement, ouvrez le fichier de configuration et ajoutez les lignes suivantes:

/etc/odoo11.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 odoo11