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éthodeInterruptionComplexitéQuand la choisir
Déploiement en place avec mode maintenanceBoutique fermée pendant toute la compilation et la génération des fichiers statiquesFaiblePetite boutique, livraisons rares, aucune autre option disponible à court terme
Répertoires de release et bascule par lien symboliqueCourte, limitée à la bascule et à la mise à jour de la base si besoinMoyenneLa plupart des boutiques sur serveur dédié ou cloud, livraisons régulières
Build séparé et déploiement d’artefactsCourte ; aucun calcul lourd sur le serveur de productionMoyenne à élevéeLivraisons 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éeForte activité, infrastructure capable de faire tourner deux environnements ; base de données à gérer avec soin
ConteneursCourte, selon l’orchestration et la gestion de la baseÉlevéeInfrastructure 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.

OutilPrincipePoints fortsPoints de vigilance
Déploiement manuel par SSHCommandes tapées à la main sur le serveurAucun outil à installerOublis, ordre des commandes variable, interruption longue, peu de traçabilité
Scripts shell maisonLes commandes de déploiement réunies dans un script versionnéSimple, adapté au contexte, répétableRetour arrière et répertoires de release à écrire soi-même
DeployerOutil PHP de déploiement fondé sur des recettes, dont une pour Magento 2Écrit en PHP, gère les releases et les dossiers partagésRecette à adapter à votre projet ; à maintenir avec ses mises à jour
CapistranoOutil Ruby de déploiement, utilisé avec des extensions dédiées à MagentoOutil éprouvé, gestion des releases et du retour arrièreDemande 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ôtTests avant livraison, artefacts, historique des déploiementsPipeline à concevoir et à maintenir ; secrets et accès à protéger
Conteneurs (Docker, Kubernetes)La boutique livrée sous forme d’images, orchestrées sur l’infrastructureEnvironnements identiques, montée en chargeComplexité 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’AdobeIntégré à la plateformeRé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 :

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 :

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

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.

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.

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.

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.

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.

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.

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.

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.