DocumentationCommerceOutils

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Création d’un plan de migration des données

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Pour migrer avec succès et éviter les problèmes, vous devez planifier et tester minutieusement votre migration.

Avant de commencer : envisagez une mise à niveau

La migration est le moment idéal pour effectuer des changements importants et préparer votre site pour le prochain niveau de croissance. Déterminez si votre nouveau site doit être conçu avec davantage de matériel ou avec une topologie plus avancée avec de meilleurs niveaux de mise en cache.

Étape 1 : vérifier les extensions sur votre site actuel

  • Quelles extensions avez-vous installées ?

  • Avez-vous déterminé si vous avez besoin de toutes ces extensions sur votre nouveau site ? Il peut y en avoir d’anciennes que vous pouvez supprimer en toute sécurité.

  • Avez-vous déterminé si des versions Magento 2 de vos extensions existent ? Rendez-vous sur Commerce Marketplace pour obtenir les dernières versions ou contactez votre fournisseur d’extensions.

  • Quelles ressources de base de données de vos extensions souhaitez-vous migrer ?

Étape 2 : créer et préparer votre boutique pour la migration

  • Configurez un système matériel Magento 2 en utilisant une topologie et une conception qui correspondent au moins à votre système Magento 1 existant

  • Installez Magento 2.x (avec tous les modules de cette version) et le Data Migration Tool sur un système conforme à la configuration requise

  • Apportez vos ajustements personnalisés au code Data Migration Tool si vous n’avez pas besoin de migrer certaines données (comme les pages CMS ou les règles de vente) ou si vous souhaitez convertir la personnalisation de Magento lors de la migration. Lisez la Data Migration ToolSpécifications techniques​ de la ​ pour mieux comprendre le fonctionnement de la migration depuis l’intérieur

Étape 3 : Exécution d’essai

Avant de commencer la migration sur l’environnement de production, il est préférable de passer par toutes les étapes de migration sur votre environnement de test.

Dans ces tests de migration, procédez comme suit :

  • Copiez votre magasin Magento 1 sur un serveur d’évaluation

  • Effectuez une migration complète du magasin Magento 1 répliqué vers Magento 2

  • Testez minutieusement votre nouvelle boutique

Étape 4 : démarrer la migration

  1. Assurez-vous que le Data Migration Tool dispose d’un accès réseau pour se connecter aux bases de données Magento 1 et Magento 2. Ouvrez les ports correspondants dans votre pare-feu.

  2. Arrêtez toutes les activités du panneau d’administration Magento 1.x (à l’exception de la gestion des commandes), telles que l’expédition, la création de factures et d’avoirs. La liste des activités autorisées peut être étendue en ajustant les paramètres du mode Delta dans le Data Migration Tool.

    note note
    NOTE
    Vous ne devez pas reprendre ces activités tant que votre boutique Magento 2 n’est pas en ligne.

  3. Nous vous recommandons d’arrêter toutes les tâches cron de Magento 1.x.

    Cependant, si certains traitements sont nécessaires pour s'exécuter pendant la migration, assurez-vous qu'ils ne créent pas de nouvelles entités de base de données ou ne modifient pas les entités existantes de la manière dont ces entités ne peuvent pas être traitées par le mode Delta.

    Par exemple, la tâche cron enterprise_salesarchive_archive_orders déplace les anciennes commandes vers l’archive. L'exécution de cette tâche pendant la migration est sécurisée, car le mode Delta reconnaît cette tâche et traite correctement les commandes archivées.

  4. Utilisez l’Data Migration Tool pour migrer les paramètres et les sites web.

  5. Copiez vos fichiers multimédias Magento 1.x dans Magento 2.x.

    Vous devez copier ces fichiers manuellement depuis le répertoire magento1-root/media vers magento2-root/pub/media.

  6. Utilisez le Data Migration Tool pour copier en bloc vos données de la base de données Magento 1 vers la base de données Magento 2.

    Si certaines de vos extensions contiennent des données que vous souhaitez migrer, vous devrez peut-être installer ces extensions adaptées à Magento 2. Si les extensions ont une structure différente dans la base de données Magento 2, utilisez les fichiers de mappage fournis avec le Data Migration Tool.

  7. Réindexez tous les indexeurs Magento 2.x. Pour plus d’informations, consultez le Gérer les indexeurs dans le Guide de configuration.

Étape 5 : apporter des modifications aux données migrées (si nécessaire)

Parfois, vous pouvez avoir besoin de votre boutique Magento 2 avec une structure de catalogue, des règles de vente et des pages CMS différentes après la migration.

Il est important de faire preuve de prudence lorsque vous effectuez des modifications manuelles des données. Les erreurs créent des erreurs dans l’étape de migration incrémentielle des données qui suit.

Par exemple, un produit supprimé de Magento 2 : celui qui a été acheté sur votre boutique Magento 1 active et qui n’est plus disponible dans votre boutique Magento 2. Le transfert des données relatives à cet achat peut entraîner une erreur lors de l'exécution du Data Migration Tool en mode Delta.

Étape 6 : mettre à jour les données incrémentielles

Après la migration des données, vous devez capturer de manière incrémentielle les mises à jour de données ajoutées dans la boutique Magento 1 (telles que les nouvelles commandes, les révisions et les modifications de profils client) et transférer ces mises à jour vers la boutique Magento 2 à l’aide du mode Delta.

  • Lancez la migration incrémentielle ; les mises à jour s’exécutent en continu. Vous pouvez arrêter de transférer des mises à jour à tout moment en appuyant sur Ctrl+C.

  • Testez votre site Magento 2 pendant cette période pour détecter d’éventuels problèmes dès que possible. Si vous rencontrez des problèmes, appuyez sur Ctrl+C pour arrêter la migration incrémentielle et la redémarrer une fois les problèmes résolus.

NOTE
Des avertissements de vérification de volume peuvent s’afficher si vous effectuez des tests sur votre site Magento 2 et exécutez le processus de migration en même temps. Cela se produit car dans Magento 2, vous créez des entités qui n’existent pas dans l’instance Magento 1.

Étape 7 : activation

Maintenant que votre site Magento 2 est à jour avec Magento 1 et fonctionne normalement, procédez comme suit pour passer au nouveau site :

  1. Mettez votre système Magento 1 en mode de maintenance (LE TEMPS D’ARRÊT DÉMARRE).

  2. Appuyez sur Ctrl+C dans la fenêtre de commande de l’outil de migration pour arrêter les mises à jour incrémentielles.

  3. Démarrez vos traitements Magento 2 cron.

  4. Dans votre système Magento 2, réindexez l’indexeur de stock. Pour plus d’informations, voir le [Guide de configuration].

  5. À l’aide d’un outil de votre choix, accédez aux pages de votre système Magento 2 pour mettre en cache les pages avant les clients qui utilisent votre storefront.

  6. Effectuez toute vérification finale de votre site Magento 2.

  7. Modifiez le DNS, les équilibreurs de charge, etc. pour pointer vers un nouveau matériel de production (DOWNTIME ENDS).

  8. Le magasin Magento 2 est maintenant prêt à l’emploi. Vous et vos clients pouvez reprendre toutes les activités.

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3