Migration drupal: transférez vos contenus et configurations depuis drupal 7 vers drupal 10

Introduction

La migration de Drupal 7 vers Drupal 10 est une étape cruciale pour les sites web qui utilisent encore cette ancienne version. Cette mise à niveau est importante pour plusieurs raisons :

Sécurité : Drupal 7 ne bénéficiera bientôt plus des mises à jour de sécurité, rendant les sites vulnérables aux attaques.
Fonctionnalités : Drupal 10 offre de nouvelles fonctionnalités et une meilleure expérience utilisateur.
Performances : Drupal 10 est plus rapide et optimisé pour les technologies modernes.
Maintenance : Il est plus facile de maintenir et de développer des sites sur la dernière version de Drupal grâce aux améliorations apportées à l'architecture du CMS.

Pour faire la migration, les options qui s'offrent à vous sont les suivantes :

Dans ce guide, nous allons aborder deux méthodes de migration :

La méthode classique fournie par Drupal, qui est une approche standard et reconnue.
La méthode développée par Habeuk, qui offre plus de maniabilité et de contrôle à l'utilisateur grâce à des modules spécifiques.

Méthode classique de migration

Pour effectuer une migration classique, il est recommandé d'utiliser les modules contrib de Drupal tels que migrate, migrate_tools, migrate_plus, et migrate_upgrade. Voici les étapes principales :

Export des configurations : Utilisez les modules migrate pour exporter les configurations de votre site Drupal 7.
Import des configurations : Importez ces configurations dans votre nouveau site Drupal 10.
Sources de référence : Pour plus de détails, consultez le Tuto sur drupal.org.

Limitations de la méthode classique

La méthode classique de migration peut parfois entraîner des pertes de données, notamment des entités et de leurs instances. Pour surmonter ces limitations, Habeuk a développé un processus plus contrôlé et sûr, organisé autour de deux modules spécifiques.

Utilisation des modules Habeuk

Une fois les configurations de base importées à l'aide des modules contrib de Drupal (migrate_tools, migrate_plus, migrate_upgrade), suivez les étapes ci-dessous pour utiliser les modules Habeuk :

Installation des modules

Drupal 7 : Installez le module migrateexport


composer require drupal/migrateexport
drush en migrateexport

Drupal 10 : Installez le module migration_hbk_auto

 
composer require drupal/migration_hbk_auto 
drush en migration_hbk_auto

Du côté Drupal 7 : Autorisez les requêtes du nouveau site

Pour que votre site Drupal 7 puisse communiquer avec le nouveau site (Drupal 10), vous devez lui donner la permission d'envoyer des requêtes. C'est un peu comme donner une clé d'accès à un nouvel ami pour qu'il puisse entrer chez vous ! 🗝️

Cette étape est essentielle pour permettre l'export des configurations et contenus vers Drupal 10. Sans elle, les deux sites ne pourront pas "se parler", et la migration ne pourra pas démarrer.

Comment faire ?

Suivez ces étapes simples pour configurer les autorisations :

Accédez à la configuration CORS : Rendez-vous à l'URL suivante dans l'administration de votre site Drupal 7 :
/admin/config/services/cors
Ajoutez l'URL du nouveau site : Dans la section des origines autorisées, ajoutez l'URL de votre site Drupal 10. Par exemple :
https://votre-site-drupal10.com
Sauvegardez la configuration : Cliquez sur "Enregistrer" pour appliquer les modifications.

Et voilà ! Votre site Drupal 7 est maintenant prêt à accepter les requêtes du nouveau site. Vous avez ouvert la porte à une migration fluide et sans accroc. 🚪✨

Alors, prêt à faire le grand saut vers Drupal 10 ? 🚀

Du côté drupal10

Prêt à migrer ? Commençons par les bases !

Avant de plonger dans les choses passionnantes, comme l'export de vos configurations et contenus, il y a une étape cruciale à ne pas négliger : configurer l'URL de votre site Drupal 7. C'est cette adresse qui servira de point de départ pour toutes les requêtes visant à récupérer vos données.

Comment procéder ?

Accédez à l'url /admin/config/system/migration-settings
Entrez l'url de votre site drupal 7 et sauvegardez la configuration.

Une fois cette étape franchie, vous serez prêt à exploiter le module migration_hbk_auto dans sont entièreté

Alors, prêt à faire le grand saut ? 🚀

Import des entités

Accédez à la page d'import des entités : /admin/migration-hbk-auto/import-from-d7

Cliquez sur le bouton "load all entities" pour charger les différentes entités de votre site Drupal 7.
Les entités s'afficheront sous forme de liste accordéon.
Déroulez l'entité que vous souhaitez traiter et cliquez sur "List bundles" pour obtenir la liste des bundles liés à cette entité.
Déroulez le bundle que vous souhaitez traiter. Cliquez sur "vérifier la configuration" pour vérifier si toutes les configurations relatives à ce bundle sont présentes.

Un mini-rapport vous sera rendu avec :

Le nombre de contenus à importer
Les champs du côté Drupal 7
Les champs du côté Drupal 10

(Si des champs sont manquants, ils seront affichés en rouge du côté Drupal 7 et "manquant" du côté Drupal 10.)

Re-importation des champs

Si des champs sont manquants ou si vous souhaitez refaire l'import des champs, cliquez sur le bouton "Re-importer tous les champs".

Import des entités

Remplissez le formulaire en bas à gauche avec les informations suivantes :

IMPORT ENTITÉ

pagination length : Définit combien de contenus seront importés par requête.
pagination start : Définit à quelle "page" l'import doit commencer.
continue : Définit si le processus d'import doit s'arrêter en cas d'erreur.

Cliquez sur le bouton "Importer les contenus" pour lancer l'import des contenus.

En prévision des cas où vous auriez besoin de ne réimporter que certaines des instances de votre contenus(vous avez fais des modifications que vous ne souhaitez pas perdre dans la plupart des instances déjà importer) , Gestion de l'import des contenus a été mis à votre disponisition et s'utilise comme suite:

Cliquez sur le bouton en question
Un popup s'affiche dans lequel vous pouvez retrouver la liste des instances de votre entité que vous pouvez gérer. Une fois que vous avez trouvé l'instance que vous souhatez récupérer, il vous suffit de cliquer sur le bouton de la colonnes d'actions pour effectuer l'import de celui-ci

Une fois toutes les configurations et instances de vos entités importées, il ne vous reste plus qu'à mettre en place votre thème et finaliser votre site Drupal 10. Félicitations, vous y êtes arrivé !

Drupal