Déploiement Odoo au Maroc : CI/CD étape par étape pour équipes multi-sites

L’adoption d’Odoo au Maroc, par les PME comme les grands groupes, s’accélère. Cependant, pour des entreprises avec des équipes techniques réparties entre Casablanca, Rabat, Marrakech ou à l’international, le déploiement manuel devient un goulot d’étranglement. Une approche CI/CD (Intégration Continue / Déploiement Continu) n’est plus une option, mais une nécessité pour assurer la qualité, la rapidité et la collaboration.

Voici un guide étape par étape pour construire un pipeline CI/CD robuste adapté à un projet Odoo multi-sites.

Étape 1 : Fondations & Prérequis (La Base du Succès)

Avant toute automatisation, il faut une base saine.

  1. Gestion de version centralisée avec Git :

    • Plateforme : Utilisez un repository unique (GitLab, GitHub, Bitbucket) pour tous les modules personnalisés, les thèmes, et les configurations.

    • Stratégie de branches : Adoptez un modèle comme Git Flow ou GitHub Flow.

      • main (ou production) : Code en production.

      • develop : Code pour l’environnement de pré-production (staging).

      • feature/* : Pour chaque nouvelle fonctionnalité.

      • hotfix/* : Pour les corrections urgentes en production.

    • Règle d’or : Jamais de commit direct sur main ou develop. Tout passe par une Pull Request (PR) / Merge Request (MR).

  2. Gestion des dépendances et de l’environnement :

    • Fichier requirements.txt : Listez toutes les versions des bibliothèques Python et des modules Odoo externes (odoo, psycopg2, etc.). C’est la clé pour des environnements identiques.

    • Docker (Fortement recommandé) : Créez un Dockerfile pour votre instance Odoo (basé sur l’image officielle Odoo) et un docker-compose.yml pour inclure PostgreSQL et tout autre service (Redis, Nginx). Cela garantit que le même environnement tourne en développement, test et production.

    • Gestion des modules : Utilisez le fichier manifest.py (__manifest__.py) dans chaque module pour déclarer les dépendances (depends).

Étape 2 : Architecture du Pipeline CI/CD

Un pipeline typique se décompose en several jobs (tâches) qui s’exécutent séquentiellement ou en parallèle.

Schéma du Pipeline :

[Push/PR sur Git] → [Lint & Tests Unitaires] → [Build Image Docker] → [Push Registry] → [Déploiement sur Staging] → [Tests E2E/Manuels] → [Déploiement sur Production] (Manuel ou Auto)

Étape 3 : Configuration des Jobs (La Pratique avec GitLab CI/CD en exemple)

Créez un fichier .gitlab-ci.yml à la racine de votre repo.

# Définition des variables globales et de l'image de base

variables:

  POSTGRES_DB: test_odoo

  POSTGRES_USER: odoo

  POSTGRES_PASSWORD: odoo

  ODOO_VERSION: "16.0" # Adapter selon votre version
# Utilisation d'une image avec Python et Docker pour builder

default:

  image: python:3.10-slim
stages:

  - lint

  - test

  - build

  - deploy-staging

  - deploy-production
# Job 1 : Linting (Qualité du code)

code_quality:

  stage: lint

  script:

    - pip install pylint odoo

    - pylint --disable=all --enable=duplicate-code,invalid-name,syntax-error,used-before-assignment *.py custom_addons/*/  # Ajuster le chemin

  only:

    - merge_requests

    - main

    - develop
# Job 2 : Tests Unitaires (Tests des modules)

unit_tests:

  stage: test

  services:

    - postgres:13  # Service de base de données éphémère pour les tests

  script:

    - pip install -r requirements.txt

    - pip install -e .

    - odoo --stop-after-init --test-enable --database=$POSTGRES_DB --config=/dev/null --addons-path=addons,custom_addons

  artifacts:

    paths:

      - coverage_report/  # Pour générer un rapport de couverture
# Job 3 : Build de l'image Docker

build_image:

  stage: build

  script:

    - docker build -t registry.example.com/odoo-maroc/mon-projet:$CI_COMMIT_SHA .

    - docker push registry.example.com/odoo-maroc/mon-projet:$CI_COMMIT_SHA

  only:

    - main

    - develop

  tags:

    - docker-runner  # Runner avec Docker installé
# Job 4 : Déploiement sur Staging (Automatique après merge dans develop)

deploy_staging:

  stage: deploy-staging

  script:

    - echo "Déploiement de l'image $CI_COMMIT_SHA sur le serveur staging"

    - ssh deploy@staging.example.com "docker pull registry.example.com/odoo-maroc/mon-projet:$CI_COMMIT_SHA && docker-compose -f /opt/odoo-staging/docker-compose.yml up -d"

  environment:

    name: staging

    url: https://staging.monprojet.ma

  only:

    - develop
# Job 5 : Déploiement sur Production ( Manuel après validation Staging)

deploy_production:

  stage: deploy-production

  script:

    - echo "Déploiement de l'image $CI_COMMIT_SHA sur le serveur production"

    - ssh deploy@prod.example.com "docker pull registry.example.com/odoo-maroc/mon-projet:$CI_COMMIT_SHA && docker-compose -f /opt/odoo-prod/docker-compose.yml up -d"

  environment:

    name: production

    url: https://monprojet.ma

  when: manual  # **Déclenchement manuel obligatoire !**

  only:

    - main

Étape 4 : Adaptation au Contexte Marocain & Multi-sites

  • Infrastructure : Choisissez un hébergeur local (Maroc Telecom Data Center, AWS/Maroc, etc.) ou cloud avec des points de présence au Maroc pour une latence optimale pour vos sites.

  • Sécurité & Conformité :

    • Hachage des mots de passe : Assurez-vous que les fichiers de configuration (odoo.conf) contenant les mots de passe DB ne sont JAMAIS dans Git. Utilisez les Variables CI/CD Secrètes ($DB_PASSWORD_PROD) injectées au moment du déploiement.

    • Données locales : Vérifiez les exigences de la Loi 09-08 sur la protection des données personnelles (LPD) concernant l’hébergement des données.

  • Collaboration inter-sites :

    • Documentation centralisée : Utilisez un Wiki (GitLab Wiki, Confluence) pour documenter le pipeline, les procédures de déploiement et les conventions de code. En français et/ou arabe si besoin.

    • Communication : Intégrez les notifications du pipeline (Slack, Teams, email) dans votre canal decommunication projet. Une notification sur le canal #dev-maroc à chaque build failed est cruciale.

    • Gestion des fuseaux horaires : Planifiez les déploiements manuels de production en dehors des heures de travail principale des autres sites (ex: fin de soirée à Casablanca, début de matinée à Paris).

Étape 5 : Tests E2E (End-to-End) et Validation

Le pipeline CI/CD doit s’arrêter avant la production!

  • Tests automatisés : Utilisez des frameworks comme Selenium avec Odoo’s test framework pour simuler des parcours utilisateur critiques (création de commande, validation d’invoice, etc.).

  • Environnement de Staging fidèle : Il doit contenir une copie anonymisée des données de production pour tester les volumes et les interactions complexes.

  • Checklist de validation manuelle : Pour le déploiement manuel en production, prévoyez une checklist courte (ex: "Vérifier le workflow de validation XYZ", "Tester l’impression du bon de livraison pour le site de Tanger"). Un membre de chaque site métier peut être requis pour signer cette checklist.

Étape 6 : Bonnes Pratiques Finales pour une Implémentation Réussie

  1. Commencez petit : Automatisez d’abord le linting et les tests unitaires. Puis le build Docker. Enfin, le déploiement staging. Le déploiement production manuel est le dernier maillon.

  2. Formez vos équipes : Tous les développeurs, où qu’ils soient (Maroc, France, Canada), doivent comprendre le flux Git et lire les logs du pipeline.

  3. Surveillez et améliorez : Utilisez les métriques du pipeline (temps d’exécution, taux d’échec) pour l’optimiser. Un pipeline lent engendre de la frustration.

  4. "Infrastructure as Code" : Gérez vos configurations de serveur (Ansible, Terraform) dans Git. Le déploiement d’un nouveau serveur Odoo pour un site distant doit être reproductible en 1 script.

  5. Plan de rollback : Votre pipeline doit pouvoir toujours revenir à la version précédente ($CI_COMMIT_BEFORE_SHA) en un clic. C’est votre filet de sécurité.

Conclusion : Plus qu’une Technologie, une Transformation

Mettre en place un CI/CD pour Odoo au Maroc, c’est adopter une culture de la quality-first et de la collaboration transparente. Pour une équipe multi-sites, cela réduit drastiquement les risques d’erreurs, accélère les livraisons de fonctionnalités et permet à chaque site de bénéficier rapidement des innovations.

Cela demande un investissement initial en temps et en formation, mais le retour sur investissement se mesure en heures de travail récupérées, en incidents de production réduits et en une cohérence parfaite de la solution Odoo à travers tous vos sites au Maroc et à l’étranger. Lancez-vous, itérez, et transformez votre façon de déployer Odoo.

Exemple concret : Une entreprise de logistique basée à Casablanca avec des entrepôts à Agadir et Kenitra, utilisant Odoo pour la gestion des stocks et des livraisons, peut ainsi déployer une correction de bug sur le module de gestion de parc véhicule en 15 minutes, testée et validée, sans impacter les opérations des autres sites.

Publications similaires