Déploiement Magento 2
Déploiement Magento 2 en production : méthodes, outils et comparatif
Déployer Magento 2 en production, c’est livrer une nouvelle version du code sans casser la boutique ni la fermer longtemps. Ce guide décrit les étapes, les méthodes pour limiter l’interruption, les outils et les contrôles avant et après.
Un bon déploiement ne se remarque pas.
Scripté, testé en préproduction et réversible, il se répète à l’identique à chaque livraison.
En bref
Le déploiement Magento 2 en production est l’opération qui installe une nouvelle version du code sur le serveur de production, puis prépare Magento à la servir : dépendances Composer sans outils de développement, mise à jour de la base avec setup:upgrade, compilation avec setup:di:compile, génération des fichiers statiques avec setup:static-content:deploy et vidage du cache. La boutique doit tourner en mode production. Pour réduire l’interruption, on construit le code et les fichiers statiques à l’écart, puis on bascule vers la nouvelle release par un lien symbolique ; seules les modifications de base de données peuvent encore demander le mode maintenance. Un déploiement fiable est scripté, testé en préproduction et accompagné d’un plan de retour arrière.
Définition
Qu’est-ce qu’un déploiement Magento 2 en production ?
Un déploiement Magento 2, ou mise en production, fait passer la boutique d’une version du code à la suivante. Copier les fichiers ne suffit pas : Magento génère du code, des fichiers statiques et des caches à reconstruire à chaque livraison.
Magento 2 fonctionne selon trois modes : default, developer et production. Le mode developer sert au développement ; le mode production, activé avec bin/magento deploy:mode:set production, sert les fichiers statiques déjà générés et le code déjà compilé. C’est le seul mode adapté à une boutique en ligne.
Un déploiement standard enchaîne les mêmes opérations : composer install --no-dev pour installer les dépendances sans outils de développement, bin/magento setup:upgrade pour appliquer les changements de schéma et de données, setup:di:compile pour générer le code compilé, setup:static-content:deploy pour produire les fichiers statiques de chaque langue et de chaque thème, puis cache:flush. On ajoute indexer:reindex si la livraison touche les index.
Cette page traite de la méthode et des outils de livraison. L’application des correctifs de sécurité est détaillée dans notre guide correctifs de sécurité et mises à jour Magento 2, et le changement de version de la plateforme dans upgrade Magento 2.
Enjeux
Pourquoi le déploiement compte autant sur Magento 2
Le déploiement est le moment où une boutique Magento 2 est la plus exposée : chaque livraison peut fermer le site, introduire une régression ou désaligner le code et la base.
Interruption
Compilation et génération des fichiers statiques prennent du temps. Faites sur le serveur de production, elles laissent la boutique fermée ou instable.
Régressions
Une livraison non testée peut casser le panier, le paiement ou une intégration. Une préproduction identique et une recette limitent ce risque.
Cohérence code et base
Le code livré attend parfois un schéma ou des données mis à jour. Un code nouveau sur une base ancienne, ou l’inverse, provoque des erreurs.
Performance après déploiement
Juste après la livraison, les caches sont vides et les premières pages sont lentes. Le préchargement du cache et la purge de Varnish font partie du déploiement.
Sécurité des accès
Un déploiement manuel ouvre des accès SSH à plusieurs personnes. Un pipeline limite ces accès et garde les secrets hors du dépôt.
Traçabilité
Savoir quelle version tourne, qui l’a livrée et quand permet de diagnostiquer un incident et de revenir à la version précédente.
Pipeline
Séparer le build et le déploiement pour limiter l’interruption
Pour déployer Magento 2 avec peu ou pas d’interruption, on sépare deux phases : le build, qui prépare le code, et le déploiement, qui l’installe. Magento documente cette approche sous le nom de déploiement par pipeline.
Le build se fait sur un système dédié, sans accès à la base de production : installation Composer, setup:di:compile et setup:static-content:deploy. Pour que ces commandes tournent sans base de données, la configuration utile (sites, thèmes, langues) doit être partagée dans le code : la commande app:config:dump sert à l’export de la configuration partagée dans app/etc/config.php, versionné, tandis que app/etc/env.php, propre à chaque environnement, garde les accès et les secrets hors du dépôt. Le résultat du build est un artefact prêt à installer.
Le déploiement copie cet artefact dans un nouveau répertoire de release sur le serveur. Les dossiers partagés entre les releases, comme pub/media, var/log et le fichier app/etc/env.php, sont reliés à la release au lieu d’être copiés. Une fois la release prête, un lien symbolique bascule d’un coup vers elle : la boutique passe de l’ancienne version à la nouvelle sans état intermédiaire.
La base de données reste le point délicat. Les modules décrivent leurs tables dans un schéma déclaratif (db_schema.xml) et leurs changements de données dans des patchs de données ou de schéma ; tous s’appliquent avec setup:upgrade. La commande setup:db:status indique, par son code de retour, si une mise à jour de la base semble nécessaire. Si oui, le mode maintenance peut rester utile pendant ce court passage, avec setup:upgrade --keep-generated pour conserver le code et les fichiers statiques issus du build. Sinon, la bascule se fait sans fermer la boutique.
Le retour arrière repose sur la release précédente, gardée sur le serveur, et sur une sauvegarde de la base faite juste avant le déploiement. Revenir au code précédent prend un changement de lien ; revenir sur une base modifiée est plus difficile, car les commandes passées entre-temps doivent être conservées : mieux vaut concevoir les changements de base compatibles avec la version précédente.
Adobe Commerce sur l’infrastructure cloud d’Adobe a son propre processus de build et de déploiement, piloté par le paquet ece-tools.
Méthodes
Comparatif des méthodes de déploiement Magento 2
La méthode de déploiement Magento 2 se choisit selon l’interruption tolérée, la fréquence des livraisons et l’infrastructure. Plus la méthode réduit l’interruption, plus elle demande de préparation.
| Méthode | Interruption | Complexité | Quand la choisir |
|---|---|---|---|
| Déploiement en place avec mode maintenance | Boutique fermée pendant toute la compilation et la génération des fichiers statiques | Faible | Petite boutique, livraisons rares, aucune autre option disponible à court terme |
| Répertoires de release et bascule par lien symbolique | Courte, limitée à la bascule et à la mise à jour de la base si besoin | Moyenne | La plupart des boutiques sur serveur dédié ou cloud, livraisons régulières |
| Build séparé et déploiement d’artefacts | Courte ; aucun calcul lourd sur le serveur de production | Moyenne à élevée | Livraisons fréquentes, plusieurs serveurs, besoin d’un artefact identique en préproduction et en production |
| Blue-green (deux environnements) | Très courte : le trafic passe d’un environnement complet à l’autre | Élevée | Forte activité, infrastructure capable de faire tourner deux environnements ; base de données à gérer avec soin |
| Conteneurs | Courte, selon l’orchestration et la gestion de la base | Élevée | Infrastructure déjà conteneurisée, équipe habituée à Docker ou Kubernetes |
Grille qualitative établie par Agillia. L’interruption réelle dépend surtout des modifications de base de données de chaque livraison.
Outils
Outils de déploiement Magento 2 : le comparatif
Le bon outil de déploiement Magento 2 est celui que votre équipe maîtrise et qui rend le déploiement scripté, répétable et réversible. Voici les options courantes.
| Outil | Principe | Points forts | Points de vigilance |
|---|---|---|---|
| Déploiement manuel par SSH | Commandes tapées à la main sur le serveur | Aucun outil à installer | Oublis, ordre des commandes variable, interruption longue, peu de traçabilité |
| Scripts shell maison | Les commandes de déploiement réunies dans un script versionné | Simple, adapté au contexte, répétable | Retour arrière et répertoires de release à écrire soi-même |
| Deployer | Outil PHP de déploiement fondé sur des recettes, dont une pour Magento 2 | Écrit en PHP, gère les releases et les dossiers partagés | Recette à adapter à votre projet ; à maintenir avec ses mises à jour |
| Capistrano | Outil Ruby de déploiement, utilisé avec des extensions dédiées à Magento | Outil éprouvé, gestion des releases et du retour arrière | Demande un environnement Ruby ; extensions Magento à suivre |
| Pipelines CI/CD (GitLab CI, GitHub Actions, Jenkins) | Le build, les tests et le déploiement lancés automatiquement depuis le dépôt | Tests avant livraison, artefacts, historique des déploiements | Pipeline à concevoir et à maintenir ; secrets et accès à protéger |
| Conteneurs (Docker, Kubernetes) | La boutique livrée sous forme d’images, orchestrées sur l’infrastructure | Environnements identiques, montée en charge | Complexité d’exploitation ; médias, sessions et base à gérer hors des conteneurs |
| Adobe Commerce Cloud (ece-tools) | Processus de build et de déploiement propre à l’infrastructure cloud d’Adobe | Intégré à la plateforme | Réservé à cette offre ; configuration à suivre dans la documentation d’Adobe |
Comparatif qualitatif et neutre établi par Agillia. Les outils se combinent souvent : un pipeline CI/CD peut lancer Deployer ou un script maison.
Méthode
Les quatre étapes d’une mise en production Magento 2
01
Préparer
La livraison est testée et validée en préproduction, la base sauvegardée et la fenêtre de déploiement annoncée.
02
Construire
Le build installe les dépendances sans outils de développement, compile le code et génère les fichiers statiques de chaque langue et thème. Le résultat est un artefact versionné.
03
Déployer
L’artefact est copié dans un nouveau répertoire de release, relié aux dossiers partagés. Le cron est arrêté, la base mise à jour si nécessaire, puis le lien symbolique bascule et le cron repart.
04
Vérifier
Cache vidé puis préchargé, Varnish purgé, parcours d’achat testé, journaux lus. Si un contrôle échoue, on revient à la release précédente.
Avant
Check-list avant un déploiement Magento 2
Avant chaque déploiement Magento 2 en production, ces points doivent être vérifiés :
- Tests : tests automatisés passés et recette fonctionnelle validée sur la livraison.
- Préproduction identique : mêmes versions de PHP, de base de données, de moteur de recherche, de Redis et de Varnish qu’en production, avec des données représentatives.
- Sauvegarde : sauvegarde récente de la base, vérifiée, et release précédente conservée sur le serveur.
- Fenêtre hors pic : créneau de faible activité, loin des soldes, des campagnes et des imports lourds.
- Plan de retour arrière : qui décide, sur quel critère, et comment revenir au code et, si besoin, à la base précédente.
- Modifications de base : savoir si la livraison change le schéma ou les données, et donc si le mode maintenance sera nécessaire.
- Notification : équipes internes, service client et prestataires prévenus de l’heure et du contenu de la livraison.
Après
Check-list après un déploiement Magento 2
Un déploiement Magento 2 n’est terminé qu’après ces contrôles en production :
- Cron relancé : les tâches planifiées tournent de nouveau et ne restent pas bloquées.
- Index : état des index vérifié, réindexation lancée si la livraison l’exige.
-
Mode maintenance levé :
bin/magento maintenance:disableexécuté, liste d’adresses IP autorisées vidée si elle a servi aux contrôles. - Cache chaud : cache vidé, Varnish purgé, pages principales préchargées pour éviter des premières visites lentes.
- Parcours d’achat : recherche, fiche produit, ajout au panier, création de compte et validation de commande.
- Paiement : au moins un paiement de test ou réel contrôlé de bout en bout, retour de confirmation compris.
- Journaux : journaux de Magento, du serveur web et de PHP lus dans les minutes et les heures qui suivent.
- Files de messages : consommateurs actifs, messages traités, flux vers l’ERP ou la logistique repartis.
Dans les jours qui suivent, une surveillance des performances Magento 2 confirme que la livraison n’a pas dégradé les temps de réponse.
Agillia
Vos déploiements Magento 2 avec Agillia
Agillia met en place et assure des déploiements Magento 2 scriptés, testés en préproduction et accompagnés d’un plan de retour arrière. Agence web depuis plus de 20 ans, nous nous appuyons sur des experts seniors qui maintiennent des sites e-commerce depuis plus de 16 ans (voir experts seniors pour votre maintenance).
Nous développons et maintenons nos propres extensions Magento 2, Sirdata CMP et KeepInHead. Livrer du code Magento 2 proprement fait donc partie de notre travail courant, pour nos modules comme pour les boutiques de nos clients.
Nous intervenons dans le cadre d’une TMA Magento 2, d’une maintenance Magento 2 ou de notre offre maintenance et sécurité Magento 2. Sur notre hébergement optimisé Magento 2, préproduction et production sont prêtes pour ce mode de livraison. Si l’état du code est mal connu, un audit global Magento 2 sert de point de départ.
Pour aller plus loin
Pour aller plus loin sur le déploiement Magento 2
- Correctifs et mises à jour Magento 2 : le processus d’application des correctifs et les commandes de mise à jour.
- Upgrade Magento 2 : le projet de montée de version, de l’audit à la bascule.
- TMA Magento 2 : la maintenance et les évolutions par une équipe senior.
- Surveillance des performances Magento 2 : détecter les lenteurs après une livraison.
- Hébergement optimisé Magento 2 : une infrastructure prête pour les déploiements par release.
- Audit performance Magento 2 : une mesure de référence avant et après vos livraisons.
- Magento 2 pour un catalogue complexe : dans quels cas Magento 2 est le bon choix.
- Lexique de la maintenance : les définitions des termes de la maintenance e-commerce.
Questions fréquentes
Vos questions sur le déploiement Magento 2
Comment déployer Magento 2 en production ?
On déploie Magento 2 en production en construisant le code, puis en l’installant sur le serveur avant de vider le cache. Les commandes clés sont composer install --no-dev, setup:upgrade, setup:di:compile, setup:static-content:deploy et cache:flush. Le tout est scripté, après recette en préproduction et sauvegarde de la base.
Peut-on déployer Magento 2 sans interruption ?
Oui, pour la plupart des livraisons, en construisant le code à l’écart puis en basculant par lien symbolique vers une nouvelle release. Seules les modifications de base de données peuvent encore demander un court passage en mode maintenance. La commande setup:db:status aide à savoir si c’est le cas.
Quel outil choisir pour déployer Magento 2 ?
Choisissez l’outil que votre équipe maîtrise et qui rend le déploiement Magento 2 scripté, répétable et réversible. Deployer, Capistrano, un script maison ou un pipeline GitLab CI, GitHub Actions ou Jenkins conviennent tous. Sur Adobe Commerce Cloud, le processus passe par ece-tools.
Quel mode utiliser pour Magento 2 en production ?
Une boutique Magento 2 en ligne doit tourner en mode production, activé avec bin/magento deploy:mode:set production. Ce mode sert le code compilé et les fichiers statiques déjà générés.
Pourquoi séparer le build et le déploiement sur Magento 2 ?
Séparer le build du déploiement retire de la production les opérations lourdes de Magento 2 : compilation et génération des fichiers statiques. La boutique reste ouverte pendant ce temps, et le même artefact peut être installé en préproduction puis en production.
Comment revenir en arrière après un déploiement Magento 2 ?
Pour revenir en arrière après un déploiement Magento 2, on rebascule le lien symbolique vers la release précédente, conservée sur le serveur. Si la base a été modifiée, la sauvegarde faite avant le déploiement sert de recours, mais ce retour est plus délicat. Les changements de base se conçoivent donc pour rester compatibles avec la version précédente.
Faut-il arrêter le cron pendant un déploiement Magento 2 ?
Oui, il est prudent d’arrêter le cron de Magento 2 pendant le déploiement et de le relancer juste après. Une tâche lancée en pleine bascule pourrait tourner sur un code ou une base incohérents.
Que faire après un déploiement Magento 2 ?
Après un déploiement Magento 2, vérifiez la boutique en production avant de considérer la livraison terminée. Contrôlez le cron, les index, le cache, le parcours d’achat, le paiement, les journaux et les files de messages.
Fiabiliser vos déploiements Magento 2
Décrivez-nous votre manière actuelle de livrer : nous vous proposons une méthode de déploiement scriptée, testée en préproduction et réversible, adaptée à votre infrastructure.
