Mis à jour le 16 novembre 2026
La réponse courte
Déployer Odoo avec Git veut dire qu'un git push est le seul chemin par lequel le code arrive sur votre Odoo. Le push prépare le code, met à jour les bons modules, redémarre Odoo et vérifie qu'il répond. Pour que ce soit sûr, un push doit faire sept choses, dans l'ordre. La plupart des pipelines faits maison en font trois.
Ce que veut dire le déploiement avec Git pour Odoo
Votre dépôt Git est le seul chemin du code vers un serveur. Vous poussez une branche. Ce push prépare le code, met à jour les modules Odoo qui en ont besoin, redémarre Odoo et vérifie qu'il marche. Chaque branche fait tourner son propre Odoo. Le développement, le staging et la production sont donc des branches que vous fusionnez, pas des serveurs où vous copiez des fichiers. Personne ne se connecte en SSH pour déployer.
Pour la plupart des applications web, c'est un problème réglé. Pour Odoo, c'est plus dur, à cause de la base de données.
Pourquoi Odoo est plus dur à déployer que la plupart des applications
Pour la plupart des applications web, un déploiement, c'est juste du code. On prend le nouveau code et on redémarre. Si ça casse, on reprend l'ancien code et on redémarre.
Odoo, c'est du code plus une base de données que le code modifie. À chaque mise à jour d'un module, Odoo change des tables, des champs et des enregistrements dans PostgreSQL. Une fois la mise à jour passée, l'ancien code ne correspond plus à la base. Vous ne pouvez donc pas revenir en arrière en reculant d'un commit. Ce seul fait explique tout ce qui suit.
Les sept choses qu'un push doit faire
1. Une copie neuve du code, pas un pull dans un dossier en service
Beaucoup de scripts lancent git pull dans le dossier des modules du serveur en production. Ce dossier est en service. Un pull qui échoue à moitié, un conflit de fusion ou un fichier modifié à la main sur le serveur peuvent tous laisser Odoo faire tourner du code qui n'existe nulle part dans Git.
La bonne méthode : un clone neuf pour chaque build, dans son propre dossier. Les sous-modules et requirements.txt y sont installés. L'Odoo en service garde l'ancienne copie jusqu'à ce que la nouvelle soit prête.
2. Le bon addons path
Odoo ne voit que les modules présents dans son addons path. Un build doit y mettre quatre choses, dans le bon ordre : vos propres modules, vos sous-modules OCA ou autres, Enterprise si vous l'avez, et les modules de la plateforme. Si vos modules sont dans un sous-dossier, c'est ce sous-dossier qui va dans le chemin, pas la racine du dépôt. Une erreur ici, et l'étape 3 ne met rien à jour, tout en disant que tout s'est bien passé.
3. La bonne liste de modules à mettre à jour
C'est l'étape que la plupart des guides ratent. odoo -u all met à jour tous les modules de la base, y compris ceux du cœur d'Odoo. Sur une grosse base, cela peut prendre une heure. Ne mettre à jour que les modules du dernier commit va plus vite, mais oublie les modules qui dépendent de celui qui a changé.
La bonne liste est simple à dire. Mettez à jour les modules installés dans la base et présents dans la nouvelle copie du code. Installé mais absent du dépôt ? On n'y touche pas. Dans le dépôt mais jamais installé ? On n'y touche pas non plus. Installer un module, c'est votre choix, pas un effet secondaire d'un push. La liste vient donc de la base, pas du diff.
4. Un point de retour avant la mise à jour
À cause de la base de données, le seul vrai retour arrière, c'est une copie de la base. Faites-la après l'arrêt d'Odoo et avant que -u ne tourne. Pas un snapshot du serveur entier. Un dump de cette seule base, pour qu'une branche puisse revenir en arrière sans toucher au reste.
Si la copie échoue, la mise à jour ne doit pas tourner. Mieux vaut un build en échec qu'une base à moitié mise à jour, sans retour possible.
5. La mise à jour, Odoo arrêté
Lancez la mise à jour des modules avec --stop-after-init pendant qu'Odoo ne sert aucun utilisateur. Une mise à jour pendant que les gens travaillent peut laisser des modules à moitié faits. Deux mises à jour en même temps le feront à coup sûr. Une seule mise à jour à la fois par branche, dans l'ordre.
odoo -c /etc/odoo/odoo.conf -d votre_base -u module_a,module_b --stop-after-init
6. Une vérification, et un retour arrière si elle échoue
Démarrez le nouvel Odoo. Vérifiez qu'il répond sur son domaine. S'il ne répond pas, restaurez la copie de l'étape 4 et remettez l'ancien Odoo en route, sans que quelqu'un lise des logs à 2 h du matin. S'il répond, l'ancienne copie du code peut partir.
C'est cette étape qui rend le déploiement par push sûr en production. Sans elle, chaque push est un pari.
7. Chaque branche est un environnement
Une branche que vous poussez devrait devenir un Odoo que vous pouvez ouvrir. Les branches de fonctionnalité ont un Odoo de courte durée. Le staging reçoit une copie de la production, sans les données privées comme les e-mails des clients. La production suit tout le processus de mise à jour ci-dessus. Fusionnez de l'une à l'autre, et le même pipeline tourne à chaque fois.
Là où s'arrêtent les pipelines faits maison
La plupart des guides de déploiement Odoo vous donnent un fichier GitHub Actions ou GitLab CI qui fait ceci : se connecter au serveur en SSH, git pull, lancer -u sur les modules du diff, redémarrer et charger la page de connexion. Certains ajoutent un pg_dump avant.
Cela couvre les étapes 1, 3 et 6, chacune en partie seulement. Et il vous reste :
- des clés SSH vers votre serveur de production, stockées en secrets CI
- un runner CI à garder à jour
- une liste de mises à jour tirée du diff, qui oublie les modules qui en dépendent
- un retour arrière qui est un script écrit une fois et jamais testé sous pression
- pas de staging, sauf si vous construisez vous-même le nettoyage des données
Rien de tout cela n'est dur à écrire. Ce qui est dur, c'est de le faire marcher pendant trois ans tout en livrant de nouvelles fonctionnalités.
Comment ça marche sur Skysize
Skysize se connecte à votre dépôt sur GitHub, GitLab ou Bitbucket. Ensuite, à chaque push :
- Un clone neuf par build. Chaque build a sa propre copie du code, avec les sous-modules, publics ou privés, et
requirements.txtinstallés. Deux conteneurs Odoo ne partagent jamais un dossier. - L'addons path, construit pour vous. Vos modules, les sous-modules, Enterprise si vous l'utilisez, et les modules de la plateforme vont dans le chemin, dans le bon ordre. Si vos modules sont dans un sous-dossier, vous indiquez ce chemin une fois par branche.
- La liste de mises à jour, tirée de la base. La mise à jour porte sur les modules installés et présents dans la nouvelle copie du code. Jamais
-u all. Les modules que vous n'avez pas installés ne sont pas touchés. - Une copie, la mise à jour, une vérification, un retour arrière. Avant la mise à jour, votre base est copiée. Après, le nouvel Odoo est vérifié sur son domaine. Si la vérification échoue, la copie revient, et l'ancien Odoo aussi, tout seul.
- Types de branches. Les branches de développement ont une courte durée de vie. Elles sont supprimées toutes seules après un temps sans nouveau build. Les branches de staging peuvent partir d'une copie de la production, sans les données privées. La production suit tout le processus de mise à jour.
- Logs de build. Chaque build enregistre ses étapes install, update, tests et requirements. Quand un build échoue, vous voyez à quelle étape.
- Pas de SSH sur votre serveur. Si Odoo tourne sur votre propre serveur, notre logiciel se connecte vers Skysize. Nous ne gardons aucun accès SSH, nous n'ajoutons aucune clé SSH sur votre serveur, et vous n'ouvrez aucun port.
Voyez chaque étape sur la page déploiements. Le même pipeline tourne sur l'infogérance Odoo, sur votre propre serveur et dans votre propre réseau, pour Community et Enterprise.
Pour le staging, lisez notre guide pour copier la production Odoo vers le staging sans envoyer d'e-mails à vos clients.
Voyez-le tourner sur votre propre dépôt
Venez avec un dépôt, et nous faisons passer une branche dans le pipeline avec vous, à l'écran. Ou connectez-le vous-même avec l'essai gratuit de 7 jours. Aucune carte bancaire demandée.
Skysize est conçu par d'anciens ingénieurs d'Odoo et certifié ISO 27001.
Parlez à un expert en hébergement Odoo
FAQ
Qu'est-ce que le déploiement avec Git pour Odoo ? Cela veut dire qu'un git push est le seul chemin du code vers un serveur Odoo. Le push prépare le code, met à jour les bons modules, redémarre Odoo et vérifie qu'il répond. Chaque branche fait tourner son propre Odoo, et personne ne déploie en SSH.
Le déploiement avec Git, c'est la même chose que le CI/CD ? Presque. Le CI/CD, c'est construire, tester et déployer à chaque commit. Le déploiement avec Git, c'est cette idée appliquée à Odoo, où le plus dur est la base de données qui change avec le code.
Puis-je déployer Odoo depuis GitLab ou Bitbucket, pas seulement GitHub ? Oui. Skysize marche avec GitHub, GitLab et Bitbucket. Le pipeline est le même pour les trois.
Un push installe-t-il de nouveaux modules ? Non. Un push met à jour les modules déjà installés. Installer un module, c'est un choix que vous faites dans Odoo.
Que se passe-t-il si la mise à jour échoue ? La copie de la base faite avant la mise à jour revient, et l'ancien Odoo aussi. Vous retrouvez l'état d'avant le push.
Les sous-modules et les dépendances Python marchent-ils ? Oui. Les sous-modules sont récupérés à chaque build, publics ou privés. Chaque sous-module privé a sa propre clé de déploiement. requirements.txt est installé dans le build.
Puis-je avoir un CI/CD comme Odoo.sh sur Odoo Community ? Oui. Les environnements par branche, le staging depuis la production, le déploiement par push et le retour arrière marchent tous sur Community, qu'Odoo.sh n'héberge pas. Ils marchent aussi sur Enterprise.